Gibt ein nullbasiertes Array zurück, das eine Teilmenge eines Zeichenfolgenarrays basierend auf angegebenen Filterkriterien enthält.
Syntax
Filter(sourcearray, match [, include ] [, compare ] )
Die Syntax der Funktion Filter weist die folgenden Argumente auf:
| Argument | Beschreibung |
|---|---|
| Quellarray | Erforderlich. Eindimensionales Array der zu durchsuchenden Zeichenfolgen. |
| Übereinstimmung | Erforderlich. Zeichenfolge, nach der gesucht werden soll. |
| include | Optional. Boolescher Wert, der angibt, ob Teilzeichenfolgen zurückgegeben werden sollen, die eine Übereinstimmung einschließen oder ausschließen. Wenn includeauf True festgelegt ist, gibt Filter die Teilmenge des Arrays zurück, das eine Übereinstimmung als Teilzeichenfolge enthält. Wenn includeauf False festgelegt ist, gibt Filter die Teilmenge des Arrays zurück, die keine Übereinstimmung als Teilzeichenfolge enthält. |
| Vergleich | Optional. Numerischer Wert, der den Typ des zu verwendenden Zeichenvergleichs angibt. Die erforderlichen Werte finden Sie im Abschnitt "Einstellungen". |
Einstellungen
Das compare-Argument kann die folgenden Werte aufweisen:
| Konstante | Wert | Beschreibung |
|---|---|---|
| vbUseCompareOption | –1 | Verwendet für einen Vergleich die Einstellung der Option Compare-Anweisung. |
| vbBinaryCompare | 0 | Führt einen binären Vergleich durch. |
| vbTextCompare | 1 | Führt einen Textvergleich durch. |
Hinweise
Wenn in sourcearray keine Übereinstimmungen gefunden werden, gibt Filter ein leeres Array zurück. Ein Fehler tritt auf, wenn sourcearraynull ist oder kein eindimensionales Array ist.
Das von der Filter-Funktion zurückgegebene Array enthält nur so viele Elemente, dass die Anzahl der übereinstimmenden Elemente erreicht wird.