Funkcia Filter

Vzťahuje sa na
Access pre Microsoft 365 Access 2024 Access 2021 Access 2019 Access 2016

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.