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. |
|
include |
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. |
Configuraçõ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. |
Comentários
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.
