Filter, fonction

---

Description

Renvoie un tableau commençant par zéro contenant un sous-ensemble d'un tableau de chaîne basé sur des critères de filtre spécifiés.

Syntaxe

Filter( InputStrings, Value[, Include[, Compare]])

La syntaxe de la fonction Filter comprend les éléments suivants :

élément	Description
InputStrings	Tableau de chaîne à une dimension dans lequel la recherche doit être effectuée.
Value	Chaîne à rechercher.
Include	Facultatif. Valeur de type Boolean indiquant s'il faut renvoyer des sous-chaînes incluant ou excluant l'argument Value. Si l'argument Include a la valeur True, la fonction Filter renvoie le sous-ensemble du tableau contenant l'argument Value comme sous-chaîne. Si l'argument Include a la valeur False, la fonction Filter renvoie le sous-ensemble du tableau ne contenant pas l'argument Value comme sous-chaîne.
Compare	Facultatif. Valeur numérique indiquant le type de comparaison de chaîne à utiliser. Reportez-vous à la section Valeurs.

Valeurs

L'argument Compare peut prendre les valeurs suivantes :

Constante	Valeur	Description
vbBinaryCompare	0	Effectue une comparaison binaire.
vbTextCompare	1	Effectue une comparaison texte.

Notes

Si aucune correspondance de l'argument Value n'est trouvée dans l'argument InputStrings, la fonction Filter renvoie un tableau vide. Une erreur se produit si l'argument InputStrings a la valeur Null ou s'il ne correspond pas à un tableau à une dimension.

Le tableau renvoyé par la fonction Filter ne contient que le nombre d'éléments suffisants pour accueillir le nombre d'éléments en correspondance.

L'exemple ci-dessous utilise la fonction Filter pour renvoyer le tableau contenant le critère de recherche "Lun" :

Dim MyIndex
Dim MyArray (3)
MyArray(0) = "Dimanche"
MyArray(1) = "Lundi"
MyArray(2) = "Mardi"
MyIndex = Filter(MyArray, "Lun") 
' MyIndex(0) contient "Lundi".

---