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:
Konstanta |
Value (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.