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. |
|
vbDatabaseCompare |
2 |
sóMicrosoft Office Access 2007. Efetua uma comparação com base nas informações na sua base de dados. |
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.