Връща масив на базата на нула, съдържащ подмножество от низов масив на базата на зададени критерии за филтриране.
Синтаксис
Filter(sourcearray; match [, include ] [, compare ] )
Синтаксисът на функцията Filter има следните аргументи:
| Аргумент | Описание |
|---|---|
| sourceArray | Задължително. Едномерен масив от низове, в които да се търси. |
| съвпадение | Задължително. Низ за търсене. |
| включи | Незадължително. Булева стойност, указваща дали да се върнат поднизове, които включват, или изключват съвпадение. Ако include е True, Filter връща подмножеството от масива, който съдържа match , като подниз. Ако включи е False, Filter връща подмножеството на масива, който не съдържа match , като подниз. |
| сравнение | Незадължително. Числова стойност, указваща вида на сравнението на низовете, които трябва да се използват. Вижте секцията "Настройки" за стойности. |
Настройки
Аргументът за сравнение може да има следните стойности:
| Константа | Стойност | Описание |
|---|---|---|
| vbUseCompareOption | –1 | Извършва сравнение, като използва настройката на командата Option Compare . |
| vbBinaryCompare | 0 | Извършва двоично сравнение. |
| vbTextCompare | 1 | Извършва текстово сравнение. |
Забележки
Ако не бъдат намерени съвпадения в sourcearray, Filter връща празен масив. Възниква грешка, ако sourcearray е Null или не е едномерен масив.
Масивът, върнат от функцията Filter , съдържа достатъчно елементи, за да съдържа броя на съвпадащите елементи.