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. Booleovská hodnota , ktorá určuje, či má funkcia vrátiť podreťazce, ktoré zahŕňajú alebo nezahŕňajú zhodu. Ak má argument includehodnotu True, funkcia Filter vráti podmnožinu poľa, ktoré obsahuje zhodu ako podreťazec. Ak má argument includehodnotu False, funkcia Filter vráti podmnožinu poľa, ktoré neobsahuje zhodu 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 v rámci zdrojového poľa nenájdu žiadne zhody zhody, funkcia Filter vráti prázdne pole. Chyba sa vyskytne, ak sourcearray má hodnotu null alebo 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.