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. |
vbDatabaseCompare |
2 |
Microsoft Office Access 2007 somente. Executa uma comparação com base em informações em seu banco de dados. |
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.