Função de filtroFilter function

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.Returns a zero-based array containing a subset of a string array based on a specified filter criteria.

SintaxeSyntax

Filtro (sourcearray, corresponder, [ incluir, [ Comparar ]])Filter(sourcearray, match, [ include, [ compare ]])


A sintaxe da função de filtro tem estes argumentos nomeados:The Filter function syntax has these named arguments:

PartePart DescriçãoDescription
SourceArraysourcearray Obrigatório.Required. Matriz unidimensional de sequências de caracteres a ser pesquisado.One-dimensional array of strings to be searched.
correspondênciamatch Obrigatório.Required. Cadeia de caracteres a ser pesquisado.String to search for.
incluirinclude Opcional.Optional. Valor booleano que indica se é necessário retornar subsequências que incluem ou excluem corresponder.Boolean value indicating whether to return substrings that include or exclude match. Se incluir for True, o filtro retorna o subconjunto da matriz que contém a corresponder como uma subcadeia de caracteres.If include is True, Filter returns the subset of the array that contains match as a substring. Se incluir for False, o filtro retorna o subconjunto da matriz que não contenha corresponder como uma subcadeia de caracteres.If include is False, Filter returns the subset of the array that does not contain match as a substring.
comparecompare Opcional.Optional. Valor numérico indicando o tipo de condição de cadeia de caracteres a ser utilizada.Numeric value indicating the kind of string comparison to use. Consulte a seção configurações para valores.See Settings section for values.

ConfiguraçõesSettings

O argumento compare pode ter os seguintes valores:The compare argument can have the following values:

ConstantConstant ValorValue DescriçãoDescription
vbUseCompareOptionvbUseCompareOption -1-1 Executa uma comparação usando a configuração da instrução Option Compare .Performs a comparison by using the setting of the Option Compare statement.
vbBinaryComparevbBinaryCompare 00 Executa uma comparação binária.Performs a binary comparison.
vbTextComparevbTextCompare 11 Executa uma comparação textual.Performs a textual comparison.
vbDatabaseComparevbDatabaseCompare 22 Somente Microsoft Access.Microsoft Access only. Executa uma comparação com base nas informações em seu banco de dados.Performs a comparison based on information in your database.

A matriz retornada pela função filtro contém apenas elementos suficientes para conter o número de itens correspondentes.The array returned by the Filter function contains only enough elements to contain the number of matched items.

Confira tambémSee also