Zwraca tablicę zerową 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 Filtruj występują następujące argumenty:
| Argument | 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ą zostać zwrócone ciągi podrzędne zawierające lub wykluczające dopasowanie. Jeśli parametr include ma wartość Prawda, funkcja Filtr zwraca podzbiór tablicy zawierającej dopasowanie jako ciąg podrzędny. Jeśli argument uwzględnianie ma wartość Fałsz, funkcja Filtr zwraca podzbiór tablicy, która nie zawiera dopasowania jako ciąg podrzędny. |
| Porównać | Argument opcjonalny. Wartość liczbowa wskazująca rodzaj porównania ciągów, którego należy użyć. Aby uzyskać wartości, zobacz sekcję Ustawienia. |
Ustawienia
Argument porównanie może mieć następujące wartości:
| Stała | Wartość | Opis |
|---|---|---|
| vbUseCompareOption | –1 | Wykonuje porównanie za pomocą ustawienia instrukcji Porównaj opcje . |
| vbBinaryCompare | 0 | Wykonuje porównanie binarne. |
| vbTextCompare | 1 | Wykonuje porównanie tekstowe. |
Uwagi
Jeśli w tablicy źródłowejnie zostaną znalezione żadne dopasowania, funkcja Filtr zwróci pustą tablicę. Błąd występuje, jeśli sourcearray ma wartość Null lub nie jest tablicą jednowymiarową.
Tablica zwrócona przez funkcję Filtr zawiera tylko tyle elementów, aby zawierała liczbę dopasowanych elementów.