Devuelve una matriz de base cero que contiene un subconjunto de una matriz de cadenas basada en un criterio de filtro especificado.
Sintaxis
Filter(sourcearray, match [, include ] [, compare ] )
La sintaxis de la función Filtro tiene estos argumentos:
| Argumento | Descripción |
|---|---|
| matriz de origen | Obligatorio. Matriz unidimensional de cadenas que se van a buscar. |
| coincidir | Obligatorio. Cadena que se va a buscar. |
| include | Opcional. Valor booleano que indica si se deben devolver subcadenas que incluyan o excluyan coincidencias. Si include es True, Filter devuelve el subconjunto de la matriz que contiene match como una subcadena. Si include es False, Filter devuelve el subconjunto de la matriz que no contiene la coincidencia como una subcadena. |
| comparar | Opcional. Valor numérico que indica el tipo de comparación de cadena que se va a usar. Vea la sección Configuración para los valores. |
Configuración
El argumento comparar puede tener los siguientes valores:
| Constante | Valor | Descripción |
|---|---|---|
| vbUseCompareOption | –1 | Realiza una comparación con la configuración de la instrucción Option Compare . |
| vbBinaryCompare | 0 | Realiza una comparación binaria. |
| vbTextCompare | 1 | Realiza una comparación textual. |
Observaciones
Si no se encuentra ninguna coincidencia en sourcearray, Filter devuelve una matriz vacía. Se produce un error si sourcearray es Null o no es una matriz unidimensional.
La matriz devuelta por la función Filter solo contiene elementos suficientes para contener el número de elementos coincidentes.