FILTER |
Filtre |
|---|---|
| ASP 3.0 | |
Syntaxe
| Function Filter(inputstrings,value[,include[,compare]]) |
Paramètres
| Nom | Description | ||
|---|---|---|---|
| inputstrings | Ce paramètre permet d'indiquer le tableau à parcourir | ||
| value | Ce paramètre permet d'indiquer la valeur à rechercher | ||
| include | Ce paramètre permet d'indiquer le mode d'inclusion : | ||
| Valeur | Description | ||
| False | Cette valeur permet d'indiquer qu'il faut indiquer si la sous-chaîne de caractères doit inclure ou exclure les valeurs. | ||
| True | Cette valeur permet d'indiquer que la sous-chaîne de caractères doit contenir la valeur de la sous-chaîne de caractères. | ||
| compare | Ce paramètre permet d'indiquer le mode comparaison : | ||
| Valeur | Constante | Description | |
| 0 | vbBinaryCompare | Cette valeur permet d'indiquer qu'il faut effectuer une comparaison binaire. | |
| 1 | vbTextCompare | Cette valeur permet d'indiquer qu'il faut effectuer une comparaison texte. | |
Description
Cette fonction retourne une tableau à partir d'une chaîne de caractères de tableau et d'un critère de filtre.
Remarques
- La fonction Filter permet de rechercher et d'extraire des éléments spécifiques d'un tableau de chaînes de caractères (inputstrings) en fonction d'une valeur donnée (value). C'est un outil très pratique pour effectuer un filtrage rapide sans avoir à écrire une boucle complexe. Elle est souvent utilisée pour traiter des listes de données textuelles, comme des noms, des catégories ou des identifiants.
- Le paramètre include, facultatif, permet de contrôler si l'on garde (True) ou exclut (False) les éléments contenant la chaîne cible. Cela rend la fonction flexible pour des cas d'usage inverses, par exemple, éliminer des éléments contenant une certaine valeur. Sans ce paramètre, la fonction agit par défaut comme un filtre inclusif.
- Si aucun élément du tableau ne correspond au filtre défini, la fonction retourne un tableau vide. Il est donc conseillé de vérifier la taille du tableau retourné avant de tenter de l'utiliser, pour éviter des erreurs ou des résultats inattendus. Cela peut se faire facilement avec UBound() et LBound().
- Le paramètre inputstrings doit impérativement être un tableau unidimensionnel de chaînes de caractères. Si vous passez une autre structure de données, comme une chaîne unique ou un tableau multidimensionnel, la fonction générera une erreur d'exécution. Il est donc important de vérifier le type et la structure des données avant utilisation.
- L'un des cas d'usage courants de Filter est dans la gestion de résultats de recherche, où on souhaite extraire des valeurs contenant un mot-clef. Par exemple, dans une liste de titres de livres ou de noms d'employés, Filter permet de rapidement localiser les entrées pertinentes. Cela améliore la lisibilité du code et réduit le besoin de structures conditionnelles complexes.
- Filter retourne un nouveau tableau contenant uniquement les éléments filtrés, ce qui signifie que le tableau d'origine reste inchangé. Cela permet de préserver l'intégrité des données d'origine tout en manipulant une version filtrée temporairement. C'est particulièrement utile dans des contextes où plusieurs filtres sont appliqués successivement.
- Bien que très utile, Filter est limitée aux chaînes de caractères et n'est pas adaptée au filtrage de tableaux contenant d'autres types de données comme les nombres ou les objets. Dans ces cas, une boucle personnalisée avec des conditions explicites est nécessaire. Cependant, pour des tableaux purement textuels, elle reste une solution rapide et élégante.
Exemple
Voici un exemple d'une utilisation typique de cette fonction :
- <%
- tableau = Array("Janvier","Fevrier","Mars","Avril","Mai","Juin","Juillet","Aout","Septembre","Octobre","Novembre","Decembre")
- Response.Write "Mars = "
- Result = Filter(tableau,"Mars")
- FOR EACH Item in Result
- Response.Write Item & ","
- NEXT
- Response.Write "<br />"
- Response.Write "ui = "
- Result = Filter(tableau,"ui")
- FOR EACH Item in Result
- Response.Write Item & ","
- NEXT
- Response.Write "<br />"
- %>
on obtiendra le résultat suivant :
Mars = Mars, ui = Juin,Juillet,Voir également
Articles - Les géants de l'informatique - Microsoft
Dernière mise à jour : Vendredi, le 10 octobre 2014