Devuelve una matriz de base cero que contiene un subconjunto de una matriz de cadena de caracteres basada en un criterio de filtro especificado.
Sintaxis
filter(sourcearray, match [, include ] [, compare ] )
La sintaxis de la función Filtro tiene los siguientes argumentos:
| Argumento | Descripción |
|---|---|
| matrizde origen | Obligatorio. Matriz unidimensional de cadenas que se van a buscar. |
| con coincidencia | Obligatorio. Cadena que se va a buscar. |
| include | Opcional. Valor booleano que indica si se devuelven subcadenas que incluyen o no coincidencias. Si include es True, Filter devuelve el subconjunto de la matriz que contiene match como subcadena. Si include es False, Filter devuelve el subconjunto de la matriz que no contiene match como subcadena. |
| comparar | Opcional. Valor numérico que indica el tipo de comparación de cadenas que se va a usar. Consulte la sección Configuración para ver los valores. |
Configuración
El argumento comparar puede tener los siguientes valores:
| Constante | Valor | Descripción |
|---|---|---|
| vbUseCompareOption | –1 | Realiza una comparación utilizando 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 encuentran coincidencias de coincidencia en la matrizsource, 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 Filtro contiene solo los elementos suficientes para contener el número de elementos coincidentes.