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.
endsWith
évalue si l'expression se termine par une sous-chaîne que vous spécifiez. Si l'expression se termine par la sous-chaîne, endsWith
renvoie vrai, sinon il renvoie faux.
Syntaxe
endsWith(
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 fait la distinction majuscules/minuscules permet d'évaluer si state_nm
endsWith "York"
.
endsWith(
state_nm
,"York"
)
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, qui ne fait pas la distinction majuscules/minuscules, permet d'évaluer si. state_nm
endsWith "york"
endsWith(
state_nm
,"york"
, 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 endsWith
fonction peut être utilisée comme instruction conditionnelle dans les fonctions If suivantes : avgIf, minIf, distinct_ countIf, countIf, maxIf, medianIf, stdevIf, stdevpIfsumIfvarIf, et. varpIf
L'exemple suivant additionne Sales
uniquement si state_nm
se termine par "York"
.
sumIf(
Sales
,endsWith(state_nm
,"York"
))
NOTContient un exemple
L'opérateur conditionnel NOT
peut être utilisé pour évaluer si l'expression ne commence pas par la sous-chaîne spécifiée.
NOT(endsWith(
state_nm
,"York"
))
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
.
endsWith(
state_nm
, toString(5
) )