Filter, functie

Van toepassing op
Access voor Microsoft 365 Access 2024 Access 2021 Access 2019 Access 2016

Deze functie retourneert een op nul gebaseerde matrix met een subset van een tekenreeksmatrix op basis van de opgegeven filtercriteria.

Syntaxis

Filter(bronarray, overeenkomst [, opnemen ] [, vergelijken ] )

De syntaxis van de functie Filter heeft deze argumenten:

Argument Beschrijving
bronmatrix Vereist. Een eendimensionale matrix van tekenreeksen die moet worden doorzocht.
overeenkomst Vereist. De tekenreeks die u zoekt.
inclusief Optioneel. Booleaanse waarde die aangeeft of subtekenreeksen moeten worden geretourneerd die overeenkomst bevatten of uitsluiten. Als opnemenWaar is, retourneert Filter de subset van de matrix die overeenkomst bevat als een subtekenreeks. Als opnemenOnwaar is, retourneert Filter de subset van de matrix die geen overeenkomst bevat als een subtekenreeks.
vergelijken Optioneel. Een numerieke waarde waarmee het type vergelijking wordt aangegeven dat moet worden gebruikt. Zie het gedeelte 'Instellingen' voor de waarden.

Instellingen

Het argument vergelijken kan de volgende waarden hebben:

Constante Waarde Beschrijving
vbUseCompareOption –1 Hiermee wordt een vergelijking uitgevoerd met de instelling van de instructie Option Compare.
vbBinaryCompare 0 Hiermee wordt een binaire vergelijking uitgevoerd.
vbTextCompare 1 Hiermee wordt een tekstvergelijking uitgevoerd.

Opmerkingen

Als er geen overeenkomsten worden gevonden in de bronarray, retourneert Filter een lege matrix. Er treedt een fout op als de bronarrayNull is of geen eendimensionale matrix is.

De matrix die wordt geretourneerd door de functie Filter, bevat net voldoende elementen voor het aantal overeenkomende items.