Retorna uma matriz baseada em zero que contém o subconjunto de uma matriz de cadeia de caracteres com base em um critério de filtro especificado.
Sintaxe
Filter(sourcearray, match [, include ] [, compare ] )
A sintaxe da função Filter tem esses argumentos:
| Argumento | Descrição |
|---|---|
| Sourcearray | Obrigatório. Matriz unidimensional de cadeias de caracteres a serem pesquisadas. |
| Jogo | Obrigatório. Cadeia de caracteres para pesquisar. |
| include | Opcional. Valor booliano que indica se deve retornar substrings que incluem ou excluem correspondência. Se a inclusão for True, Filter retornará o subconjunto da matriz que contém correspondência como uma substring. Se a inclusão for False, Filter retornará o subconjunto da matriz que não contém correspondência como uma substring. |
| comparar | Opcional. Valor numérico que indica o tipo de comparação de cadeia de caracteres a ser usada. Consulte Seção Configurações para obter valores. |
Configurações
O argumento compare pode ter os seguintes valores:
| Constante | Valor | Descrição |
|---|---|---|
| vbUseCompareOption | –1 | Executa uma comparação usando a configuração da instrução Option Compare . |
| vbBinaryCompare | 0 | Executa uma comparação binária. |
| vbTextCompare | 1 | Executa uma comparação textual. |
Comentários
Se nenhuma correspondência for encontrada no sourcearray, Filter retornará uma matriz vazia. Ocorre um erro se o sourcearray for Null ou não for uma matriz unidimensional.
A matriz retornada pela função Filter contém apenas elementos suficientes para conter o número de itens correspondentes.