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