Filter (Función)

       

Descripción

Devuelve una matriz basada en ceros que contiene un subconjunto de una matriz de cadenas basada en unos criterios de filtro especificados.

Sintaxis

Filter(sourcesrray, match[, include[, compare]])

La sintaxis de la función Filter consta de los siguientes argumentos con nombre:

Parte	Descripción
sourcearray	Requerido. La matriz de cadenas de una dimensión donde se buscará.
match	Requerido. Cadena que se va a buscar.
include	Opcional. Valor Boolean que indica si la función cebe devolver subcadenas que incluyan o excluyan match. Si include es True, la función Filter devuelve el subconjunto de la matriz que contiene match como una subcadena. Si include es False, la función Filter devuelve el subconjunto de la matriz que no contiene valor como una subcadena.
compare	Opcional. El valor numérico que indica la clase de comparación de cadenas que se va a utilizar. Vea la sección Valores para consultar los valores posibles.

Valores

El argumento compare puede tener los valores siguientes:

Constante	Valor	Descripción
vbUseCompareOption	–1	Realizar una comparación utilizando el valor de la instrucción Option Compare.
vbBinaryCompare	0	Realizar una comparación binaria.
vbTextCompare	1	Realizar una comparación basada en el texto.
vbDatabaseCompare	2	Sólo para Microsoft Access. Realizar una comparación basada en información de su base de datos.

Comentarios

Si no se encuentran coincidencias de match dentro de sourcearray, la función Filter devuelve una matriz vacía. Se produce un error si sourcearray es Null o no es una matriz de una dimensión.

La matriz devuelta por la función Filter sólo contiene elementos suficientes para contener el número de elementos coincidentes.