contains - Amazon QuickSight

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, minIf, distinct_countIf, countIf, maxIf, medianIf, stdevIf, stdevpIf, sumIf, varIf et varpIf.

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) )