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