Função Filtrar

  • Artigo

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.