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 označujúca, či sa majú vrátiť podreťazce, ktoré obsahujú alebo nezahŕňajú zhodu. Ak má argument zahrnutiehodnotu True, funkcia Filter vráti podmnožinu poľa, ktoré obsahuje zhodu ako podreťazec. Ak má argument zahrnutiehodnotu 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 porovnania môže mať nasledujúce 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 zdrojovej tabuľke nenájdu žiadne zhody, funkcia Filter vráti prázdne pole. Ak má sourcearrayhodnotu Null alebo nie je jednorozmerným poľom, vyskytne sa chyba.
Pole, ktoré vráti funkcia Filter, obsahuje len toľko prvkov, aby obsiahli príslušný počet zhodných položiek.