in

Syntaxe

Paramètres

Description

Cette fonction permet de vérifier si une chaîne de texte appartient à une collection ou un tableau, sans respecter la casse.

Remarques

• Opérateur de recherche simple et lisible : L'opérateur in est utilisé pour vérifier si un élément existe dans une collection, un tableau ou une chaîne de texte. Il rend la syntaxe plus naturelle et intuitive que des formules plus complexes basées sur des fonctions comme LookUp() ou Filter() pour de simples vérifications d'appartenance.
• Insensible à la casse : L'un des grands avantages de in en Power Fx est qu'il ne tient pas compte de la casse des lettres. Cela signifie que "apple" in ["Apple", "Banana"] renvoie true, ce qui simplifie le traitement de textes provenant de l'utilisateur sans avoir à normaliser systématiquement la casse.
• Utile dans les validations de formulaire : On peut facilement utiliser in pour vérifier si une valeur entrée par un utilisateur figure dans une liste de choix valides. Par exemple, TextInput1.Text in ["Oui", "Non", "Peut-être"] permet d'accepter uniquement certaines réponses dans un champ, tout en restant tolérant sur la casse.
• Fonctionne aussi sur les chaînes de caractères : Lorsqu'il est utilisé avec des chaînes de texte, in peut également tester si une sous-chaîne est contenue dans une autre. Par exemple, "test" in "Ceci est un test" retourne true, ce qui rend cet opérateur utile pour des recherches ou des filtrages simples dans des blocs de texte.
• Équivalent simplifié d'une boucle de recherche : Avec in, il n'est plus nécessaire d'itérer manuellement sur une collection pour vérifier si un élément y est présent. L'opérateur remplace efficacement une boucle ou une recherche explicite, ce qui rend le code plus concis et plus performant.
• Particulièrement utile avec les galeries et collections : Lorsqu'on travaille avec des galeries dans Power Apps, on peut utiliser in pour filtrer ou surligner certains éléments qui correspondent à une valeur de référence. Par exemple, ThisItem.Category in SelectedCategories permet de n'afficher que certains objets d'une collection.
• Attention à la comparaison de types : Même si la comparaison ne tient pas compte de la casse, elle reste sensible au type de données. Ainsi, le nombre 5 ne sera pas considéré comme égal à la chaîne "5", sauf conversion explicite. Il est donc important de s'assurer que les types sont compatibles dans l'utilisation de in.
• Combine efficacité et clarté du code : L'opérateur in permet d'écrire des formules plus courtes, lisibles et faciles à maintenir. Il s'adapte aussi bien à des expressions conditionnelles qu'à des filtres d'affichage ou des validations, ce qui en fait un outil polyvalent et fortement recommandé pour les vérifications simples d'appartenance.