Renvoie un tableau de base zéro contenant un sous-ensemble d’un tableau de chaînes basé sur un critère de filtre spécifié.
Syntaxe
Filter(sourcearray, match [, include ] [, compare ] )
La syntaxe de la fonction Filtre contient les arguments suivants :
| Argument | Description |
|---|---|
| Tableau source | Obligatoire. Tableau unidimensionnel de chaînes à rechercher. |
| correspondre | Obligatoire. Chaîne à rechercher. |
| inclure | Facultatif. Valeur booléenne indiquant si les sous-chaînes qui incluent ou excluent la correspondance doivent être renvoyées. Si include est True, Filtre retourne le sous-ensemble du tableau qui contient match en tant que sous-chaîne. Si include est False, Filtre retourne le sous-ensemble du tableau qui ne contient pas de correspondance en tant que sous-chaîne. |
| comparaison | Facultatif. Valeur numérique indiquant le type de comparaison de chaînes à utiliser. Voir la section Paramètres pour les valeurs. |
Paramètres
L’argument de comparaison peut avoir les valeurs suivantes :
| Constante | Valeur | Description |
|---|---|---|
| vbUseCompareOption | –1 | Effectue une comparaison en utilisant le paramètre de l’instruction Option Compare . |
| vbBinaryCompare | 0 | Effectue une comparaison binaire. |
| vbTextCompare | 1 | Effectue une comparaison textuelle. |
Remarques
Si aucune correspondance de correspondance n’est trouvée dans le tableau source, Filtre renvoie un tableau vide. Une erreur se produit si le tableau source est Null ou n’est pas un tableau unidimensionnel.
Le tableau renvoyé par la fonction Filter contient uniquement assez d’éléments pour contenir le nombre d’éléments correspondants.