Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # contains `contains` évalue si la sous-chaîne que vous spécifiez existe dans une expression. Si l’expression contient la sous-chaîne, contains renvoie un résultat vrai, sinon il renvoie un résultat faux. ## Syntaxe ``` contains(expression, substring, string-comparison-mode) ``` ## Arguments *expression* L’expression doit être une chaîne. Il peut s’agir du nom d’un champ qui utilise le type de données de chaîne, d’une valeur littérale comme **'12 Main Street'** ou d’un appel à une autre fonction qui renvoie une chaîne. *substring* L’ensemble des caractères à vérifier par rapport à l’*expression*. La sous-chaîne peut être contenue une ou plusieurs fois dans l’*expression*. *string-comparison-mode* (Facultatif) Spécifie le mode de comparaison de chaînes à utiliser : + `CASE_SENSITIVE` – Les comparaisons de chaînes sont sensibles à la casse. + `CASE_INSENSITIVE` – Les comparaisons de chaînes sont insensibles à la casse. La valeur par défaut est `CASE_SENSITIVE` lorsqu’elle est vide. ## Type de retour Booléen ## Exemples ### Exemple de sensibilité à la casse par défaut L’exemple suivant, sensible à la casse, évalue si `state_nm` contient **New**. ``` contains(state_nm, "New") ``` Les valeurs suivantes sont celles du champ donné. ``` New York new york ``` Pour ces valeurs, les valeurs suivantes sont renvoyées. ``` true false ``` ### Exemple insensible à la casse L’exemple suivant, insensible à la casse, évalue si `state_nm` contient **new**. ``` contains(state_nm, "new", CASE_INSENSITIVE) ``` Les valeurs suivantes sont celles du champ donné. ``` New York new york ``` Pour ces valeurs, les valeurs suivantes sont renvoyées. ``` true true ``` ### Exemple avec des instructions conditionnelles La fonction contains peut être utilisée comme instruction conditionnelle dans les fonctions If suivantes : [avgIf](https://docs.aws.amazon.com/quicksight/latest/user/avgIf-function.html), [minIf](https://docs.aws.amazon.com/quicksight/latest/user/minIf-function.html), [distinct\$1countIf](https://docs.aws.amazon.com/quicksight/latest/user/distinct_countIf-function.html), [countIf](https://docs.aws.amazon.com/quicksight/latest/user/countIf-function.html), [maxIf](https://docs.aws.amazon.com/quicksight/latest/user/maxIf-function.html), [medianIf](https://docs.aws.amazon.com/quicksight/latest/user/medianIf-function.html), [stdevIf](https://docs.aws.amazon.com/quicksight/latest/user/stdevIf-function.html), [stdevpIf](https://docs.aws.amazon.com/quicksight/latest/user/stdevpIf-function.html), [sumIf](https://docs.aws.amazon.com/quicksight/latest/user/sumIf-function.html), [varIf](https://docs.aws.amazon.com/quicksight/latest/user/varIf-function.html) et [varpIf](https://docs.aws.amazon.com/quicksight/latest/user/varpIf-function.html). L’exemple suivant additionne `Sales` uniquement si `state_nm` contient **New**. ``` sumIf(Sales,contains(state_nm, "New")) ``` ### Exemple « ne contient PAS » L’opérateur conditionnel `NOT` peut être utilisé pour évaluer si l’expression ne contient pas la sous-chaîne spécifiée. ``` NOT(contains(state_nm, "New")) ``` ### Exemple d’utilisation de valeurs numériques Des valeurs numériques peuvent être utilisées dans les arguments d’expression ou de sous-chaîne en appliquant la fonction `toString`. ``` contains(state_nm, toString(5) ) ```