Deze functie retourneert een op nul gebaseerde matrix met een subset van een tekenreeksmatrix op basis van de opgegeven filtercriteria.
Syntaxis
Filter(sourcearray, overeenkomst [, include] [, 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. Een Booleaanse waarde die aangeeft of subtekenreeksen moeten worden geretourneerd die overeenkomende tekenreeksen bevatten of uitsluiten. Als includeWaar is, retourneert Filter de subset van de matrix die overeenkomst bevat als een subtekenreeks. Als opnemenOnwaar is, wordt met Filter de subset van de matrix geretourneerd die geen overeenkomst als subtekenreeks bevat. |
| 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 van overeenkomst zijn gevonden in de bronmatrix, retourneert Filter een lege matrix. Er treedt een fout op als sourcearrayNull is of geen eendimensionale matrix is.
De matrix die wordt geretourneerd door de functie Filter, bevat net voldoende elementen voor het aantal overeenkomende items.