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 Filtrar tem os seguintes argumentos:
| Argumento | Descrição |
|---|---|
| matriz_fonte | Obrigatório. Matriz unidimensional de cadeias de caracteres a serem pesquisadas. |
| correspondência | Obrigatório. Cadeia para procurar. |
| incluir | Opcional. Valor booleano que indica se devem ser devolvidas subcadeias que incluam ou excluam correspondência. 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 cadeia a utilizar. Consulte a secção Definições para obter os valores. |
Definições
O argumento comparar pode ter os seguintes valores:
| Constante | Valor | Descrição |
|---|---|---|
| vbUseCompareOption | –1 | Efetua uma comparação utilizando a definição da instrução Option Compar . |
| vbBinaryCompare | 0 | Efetua uma comparação binária. |
| vbTextCompare | 1 | Efetua uma comparação textual. |
Observações
Se não forem encontradas correspondências na matriz-fonte, Filtrar devolverá uma matriz vazia. Um erro ocorre se sourcearray for Null ou não for uma matriz unidimensional.
A matriz devolvida pela função Filtrar contém apenas elementos suficientes para conter o número de itens correspondentes.