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. |
|
vbDatabaseCompare |
2 |
Microsoft Office Access 2007 uniquement. Effectue une comparaison basée sur les informations de votre base de données. |
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.
