Vrátí pole založené na nule obsahující podmnožinu řetězcového pole na základě zadaných kritérií filtru.
Syntaxe
Filter(sourcearray, match [; include ] [; compare ] )
Syntaxe funkce Filter má tyto argumenty:
| Argument | Popis |
|---|---|
| Sourcearray | Povinný argument. Jednorozměrné pole řetězců, které se mají prohledávat. |
| Zápas | Povinný argument. Řetězec, který chcete vyhledat. |
| zahrnuje | Nepovinný argument. Logická hodnota označující, jestli se mají vrátit podřetětěce, které zahrnují nebo vyloučí shodu. Pokud má argument includehodnotu True, vrátí funkce Filter podmnožinu pole, které obsahuje shodu , jako podřetěžce. Pokud je argument includefalse, vrátí funkce Filter podmnožinu pole, které neobsahuje shodu , jako podřetěžce. |
| Porovnat | Nepovinný argument. Číselná hodnota označující typ porovnání řetězců, který se má použít. Hodnoty najdete v části Nastavení. |
Nastavení
Argument compare může mít následující hodnoty:
| Konstantní | Hodnota | Popis |
|---|---|---|
| vbUseCompareOption | –1 | Provede porovnání pomocí nastavení příkazu Porovnání možností . |
| vbBinaryCompare | 0 | Provede binární porovnání. |
| vbTextCompare | 1 | Provede textové porovnání. |
Poznámky
Pokud nejsou nalezeny žádné shody v rámci sourcearray, vrátí funkce Filter prázdné pole. K chybě dojde, pokud sourcearray má hodnotu Null nebo není jednorozměrné pole.
Pole vrácené funkcí Filter obsahuje pouze dostatek prvků, které obsahují počet odpovídajících položek.