Função Filtrar
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 Filter tem estes argumentos nomeados:
| Sair | 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 subconserção. |
| compare | Opcional. Valor numérico que indica o tipo de comparação de cadeia de caracteres a ser usada. 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.