Atgriež nulles bāzes masīvu, kas ietver tāda virknes masīva apakškopu, kura pamatā ir norādītais filtra kritērijs.
Sintakse
Filter(sourcearray, match [, include ] [, compare ] )
Funkcijas Filter sintaksei ir šādi argumenti:
| Arguments | Apraksts |
|---|---|
| SourceArray | Obligāts arguments. Viendimensijas meklējamo virkņu masīvs. |
| Atbilstība | Obligāts arguments. Meklējamā virkne. |
| include | Neobligāts arguments. Būla vērtība , kas norāda, vai atgriezt apakšvirknes, kas iekļauj vai izslēdz atbilstību. Ja iekļaut ir True, FILTER atgriež masīva apakškopu, kurā kā apakšvirkne ir atbilstība iekļauta. Ja iekļaut ir Aplams, FILTER atgriež masīva apakškopu, kurā nav atbilstības kā apakšvirkne. |
| salīdzināt | Neobligāts arguments. Skaitliska vērtība, kas norāda izmantojamā virkņu salīdzinājuma veidu. Skatiet vērtību sadaļu Iestatījumi. |
Iestatījumi
Salīdzināšanas argumentam var būt šādas vērtības:
| Konstante | Vērtība | Apraksts |
|---|---|---|
| vbUseCompareOption | –1 | Veic salīdzinājumu, izmantojot priekšraksta Opciju salīdzināšana iestatījumu. |
| vbBinaryCompare | 0 | Veic bināru salīdzinājumu. |
| vbTextCompare | 1 | Veic teksta salīdzinājumu. |
Piezīmes
Ja avota masīvā netiek atrasta neviena atbilstības atbilstība, Filter atgriež tukšu masīvu. Kļūda rodas, ja sourcearray ir Null vai nav viendimensijas masīvs.
Funkcijas Filter atgrieztajā masīvā ir tikai pietiekami daudz elementu, lai ietvertu atbilstošu vienumu skaitu.