Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Retorna uma matriz baseada em zero que contém um 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 Filtrar tem estes argumentos nomeados:
| Sair | Descrição |
|---|---|
| SourceArray | Obrigatório. Matriz unidimensional de cadeias de caracteres a serem pesquisadas. |
| match | Obrigatório. Cadeia de caracteres a ser pesquisada. |
| include | Opcional. Valor booleano que indica se as subcadeias de caracteres que incluem ou excluem correspondem. Se include for True, Filter retornará o subconjunto da matriz que contém a correspondência como uma substring. Se include for False, Filter retornará o subconjunto da matriz que não contém correspondência como uma substring. |
| compare | Opcional. Valor numérico que indica o tipo de comparação de cadeia de caracteres a ser usado. Confira a seção Configurações para obter os valores. |
Configurações
O argumento compare pode ter os seguintes valores:
| Constant | Valor | Descrição |
|---|---|---|
| vbUseCompareOption | -1 | Executa uma comparação usando a configuração da instrução da Option Compare. |
| vbBinaryCompare | 0 | Executa uma comparação binária. |
| vbTextCompare | 1 | Executa uma comparação textual. |
| vbDatabaseCompare | 2 | Somente Microsoft Access. Executa uma comparação baseada nas informações do seu banco de dados. |
A matriz retornada pela função Filter contém apenas elementos suficientes para conter o número de itens correspondentes.
Confira também
Suporte e comentários
Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.