Возвращает массив с нулевым начальным индексом, содержащий выборку из строкового массива на основе указанного условия отбора.
Синтаксис
Filter(sourcearray, match [, include ] [, compare ] )
Функция Filter имеет следующие аргументы:
| Аргумент | Описание |
|---|---|
| исходный_массив | Обязательный аргумент. Одномерный строковый массив, в котором выполняется поиск. |
| шаблон | Обязательный аргумент. Искомая строка. |
| включить | — необязательный аргумент. Логическое значение, указывающее, следует ли возвращать подстроки, которые включают или исключают совпадение. Если параметру includeприсвоено значение True, фильтр возвращает подмножество массива, содержащего совпадение в качестве подстроки. Если параметр include имеет значение False, фильтр возвращает подмножество массива, который не содержит совпадения в качестве подстроки. |
| compare | Необязательный аргумент. Представляет собой числовое значение, указывающее вид сравнения строк. Возможные значения см. в разделе "Параметры". |
Параметры
Аргумент сравнения может иметь следующие значения:
| Константа | Значение | Описание |
|---|---|---|
| vbUseCompareOption | -1 | Выполняется сравнение с помощью параметра инструкции Option Compare. |
| vbBinaryCompare | 0 | Выполняется двоичное сравнение. |
| vbTextCompare | 1 | Выполняется текстовое сравнение. |
Замечания
Если совпадения вsourcearray не найдены, фильтр возвращает пустой массив. Ошибка возникает, если sourcearray имеет значение NULL или не является одномерным массивом.
Массив, возвращенный функцией Filter, содержит только такие элементы, в которых количество символов достаточно для сравнения с шаблоном.