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 Übereinstimmung ein- oder ausschließen. Wenn includeTrue ist, gibt Filter die Teilmenge des Arrays, die Übereinstimmung enthält, als Teilzeichenfolge zurück. Wenn include False 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 Argument compare kann die folgenden Werte annehmen:
| 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 keine Übereinstimmungen der Übereinstimmung innerhalb von sourcearray gefunden werden, gibt Filter ein leeres Array zurück. Ein Fehler tritt auf, wenn "sourcearray"gleich Null 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.