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