Zwraca tablicę opartą na zerze, zawierającą podzbiór tablicy ciągów na podstawie określonych kryteriów filtru.
Składnia
Filter(sourcearray, match [, include ] [, compare])
W składni funkcji Filtr występują następujące argumenty:
| Argumenty argumentów | Opis |
|---|---|
| sourcearray | Argument wymagany. Jednowymiarowa tablica ciągów do przeszukania. |
| Mecz | Argument wymagany. Ciąg do wyszukania. |
| zawiera | Argument opcjonalny. Wartość logiczna wskazująca, czy mają być zwracane podciągi, które zawierają lub wykluczają dopasowanie. Jeśli argument dołączony ma wartość Prawda, funkcja Filtr zwraca podzbiór tablicy zawierającej argument "dopasuj " jako podciąg. Jeśli parametr include ma wartość False, funkcja Filter zwraca podzbiór tablicy, który nie zawiera match jako podciąg. |
| porównaj | Argument opcjonalny. Wartość liczbowa wskazująca rodzaj porównania ciągów, które ma zostać użyte. Wartości można znaleźć w sekcji Ustawienia. |
Ustawienia
Argument porównania może mieć następujące wartości:
| Stała | Wartość | Opis |
|---|---|---|
| vbUseCompareOption | –1 | Wykonuje porównanie przy użyciu ustawienia instrukcji Option Compare . |
| vbBinaryCompare | 0 | Wykonuje porównanie binarne. |
| vbTextCompare | 1 | Wykonuje porównanie tekstu. |
Uwagi
Jeśli w tablicy źródłowejnie zostaną znalezione żadne dopasowania, filtr zwraca pustą tablicę. Błąd występuje, jeśli sourcearray ma wartość Null lub nie jest tablicą jednowymiarową.
Tablica zwrócona przez funkcję Filter zawiera tylko tyle elementów, aby mieściła się taka liczba dopasowanych elementów.