Повертає масив на основі нуля з підмножиною масиву рядків відповідно до заданих умов фільтра.
Синтаксис
Filter(sourcearray, match [, include ] [, compare] )
Синтаксис функції Filter має такі аргументи:
| Аргумент | Опис |
|---|---|
| sourcearray | Обов’язковий аргумент. Одновимірний масив рядків, які потрібно шукати. |
| match | Обов’язковий аргумент. Рядок, який потрібно шукати. |
| include | — необов’язковий аргумент. Логічне значення, що вказує, чи потрібно повертати підрядки, які містять або не містять збіг. Якщо значення Include має значення True, функція Filter повертає підмножину масиву, що містить аргумент match , як підрядок. Якщо include має значення False, функція FILTER повертає підмножину масиву, що не містить аргумент MATCH як підрядок. |
| compare | — необов’язковий аргумент. Числове значення, яке вказує на потрібний вид порівняння рядків. Значення див. в розділі "Параметри". |
Параметри
Аргумент порівняння може мати такі значення:
| Константа | Значення | Опис |
|---|---|---|
| vbUseCompareOption | –1 | Виконує порівняння за допомогою параметра оператора Option Compare. |
| vbBinaryCompare | 0 | Виконує двійкове порівняння. |
| vbTextCompare | 1 | Виконує текстове порівняння. |
Примітки
Якщо в sourcearray відсутні збіги, функція Filter повертає пустий масив. Якщо аргумент sourcearray має Null-значення або не є одновимірним масивом, станеться помилка.
Масив, повернутий функцією Filter, містить рівно стільки елементів, скільки потрібно, щоб помістити кількість відповідних елементів.