Vráti nulové pole obsahujúce podmnožinu poľa reťazcov na základe špecifických filtrovacích kritérií.
Syntax
Filter( sourcearray , match [, include ] [, compare ] )
Syntax funkcie Filter má tieto argumenty:
Argument |
Popis |
---|---|
sourcearray |
Povinný argument. Jednorozmerné pole reťazcov, v ktorých sa má vyhľadávať. |
match |
Povinný argument. Reťazec, ktorý chcete vyhľadať. |
include |
Voliteľný argument. Hodnota typu Boolean, ktorá určuje, či má funkcia vrátiť podreťazce, ktoré zahŕňajú alebo nezahŕňajú argument match. Ak má argument include hodnotu True, funkcia Filter vráti podmnožinu poľa, ktoré obsahuje argument match ako podreťazec. Ak má argument include hodnotu False, funkcia Filter vráti podmnožinu poľa, ktoré neobsahuje argument match ako podreťazec. |
compare |
Voliteľný argument. Číselná hodnota, ktoré označuje druh porovnávania reťazcov, ktoré sa má použiť. Hodnoty nájdete v časti Nastavenie. |
Nastavenia
Argument compare môže mať tieto hodnoty:
Konštanta |
Hodnota |
Popis |
---|---|---|
vbUseCompareOption |
–1 |
Vykonáva porovnanie pomocou nastavenia príkazu Option Compare. |
vbBinaryCompare |
0 |
Vykonáva porovnanie na základe binárnych údajov. |
vbTextCompare |
1 |
Vykonáva textové porovnanie. |
Poznámky
Ak sa žiadne zhody argumentu match nenájdu v rámci argumentu sourcearray, funkcia Filter vráti prázdne pole. Chyba sa vyskytne, ak argument sourcearray je typu Null alebo ak nie je jednorozmerným poľom.
Pole, ktoré vráti funkcia Filter, obsahuje len toľko prvkov, aby obsiahli príslušný počet zhodných položiek.