Retourne 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 Filter contient les arguments suivants :
| Argument | Description |
|---|---|
| sourcearray | Obligatoire. Tableau unidimensionnel de chaînes à rechercher. |
| correspondance | Obligatoire. Chaîne à rechercher. |
| inclure | Facultatif. Valeur booléenne indiquant s’il faut retourner des sous-chaînes qui incluent ou excluent la correspondance. Si include a la valeur True, Filter renvoie le sous-ensemble du tableau qui contient la correspondance en tant que sous-chaîne. Si include a la valeur False, Filter renvoie 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. Consultez la section Paramètres pour connaître les valeurs. |
Paramètres
L’argument compare peut avoir les valeurs suivantes :
| Constante | Valeur | Description |
|---|---|---|
| vbUseCompareOption | –1 | Effectue une comparaison à l’aide du 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 sourcearray, Filter renvoie un tableau vide. Une erreur se produit si sourcearray a la valeur Null ou n’est pas un tableau unidimensionnel.
Le tableau retourné par la fonction Filter contient uniquement suffisamment d’éléments pour contenir le nombre d’éléments correspondants.