Devolve uma matriz baseada em zero que contém o subconjunto de uma matriz de cadeia com base num critério de filtro especificado.
Sintaxe
Filter( sourcearray , match [, include ] [, compare ] )
A sintaxe da função Filter tem estes argumentos:
Argumento |
Descrição |
---|---|
matriz de origem |
Obrigatório. Matriz unidimensional de cadeias a procurar. |
corresponder |
Obrigatório. Cadeia a procurar. |
incluir |
Opcional. Valor booleano que indica se as subcadeias que incluem ou excluem correspondem. Se incluir for Verdadeiro, Filtro devolve o subconjunto da matriz que contém a correspondência como uma subcadeia. Se incluir for Falso, Filtro devolve o subconjunto da matriz que não contém correspondência como uma subcadeia. |
comparar |
Opcional. Valor numérico que indica o tipo de comparação de cadeias a utilizar. Veja a secção Definições para obter valores. |
Definições
O argumento comparar pode ter os seguintes valores:
Constante |
Valor |
Descrição |
---|---|---|
vbUseCompareOption |
–1 |
Efetua uma comparação com a definição da instrução Comparação de Opções . |
vbBinaryCompare |
0 |
Efetua uma comparação binária. |
vbTextCompare |
1 |
Efetua uma comparação textual. |
Observações
Se não forem encontradas correspondências de correspondência na matriz de origem, Filtro devolve uma matriz vazia. Ocorre um erro se a matriz de origem for nula ou não for uma matriz unidimensional.
A matriz devolvida pela função Filter contém apenas elementos suficientes para conter o número de itens correspondentes.