Fonctions de chaîne string-functions

Les fonctions de chaîne vous permettent de manipuler et d’utiliser des valeurs de texte dans vos expressions de parcours. Ces fonctions sont essentielles pour le traitement de texte, la validation, la transformation et l’analyse dans vos parcours clients.

Utilisez des fonctions de chaîne lorsque vous devez :

Les fonctions de chaîne fournissent des fonctionnalités complètes de manipulation de texte, permettant un traitement des données sophistiqué et une logique conditionnelle basée sur le contenu texte de vos expressions de parcours.

concat concat

Concatène deux paramètres de chaîne ou une liste de chaînes.

Syntaxe
concat(<parameters>)
Paramètres
table 0-row-2 1-row-2 2-row-2
Paramètre Type
Liste listString
chaîne Chaîne
Signature et type renvoyé

concat(<string>,<string>)

concat(<listString>)

Renvoie une chaîne.

Exemples

concat("Hello","World")

Renvoie « HelloWorld ».

concat(["Hello"," ","World"])

Renvoie « Hello World ».

contain contain

Vérifie si la chaîne du deuxième argument est contenue dans la chaîne du premier argument.

Syntaxe
contain(<parameters>)
Paramètres
  • Chaîne
Signature et type renvoyé

contain(<string>,<string>)

Renvoie une valeur booléenne.

Exemples

contain("rowing is great", "great")

Renvoie true.

containIgnoreCase containIgnoreCase

Vérifie si la chaîne du deuxième argument est contenue dans la chaîne du premier argument, sans tenir compte de la casse.

Syntaxe
containIgnoreCase(<parameters>)
Paramètres
table 0-row-2 1-row-2 2-row-2
Paramètre Type
chaîne chaîne
chaîne recherchée Chaîne
Signature et type renvoyé

containIgnoreCase(<string>,<string>)

Renvoie une valeur booléenne.

Exemples

containIgnoreCase("rowing is great", "GREAT")

Renvoie true.

endWith endWith

Renvoie « true » si le deuxième paramètre est un suffixe du premier.

Syntaxe
endWith(<parameters>)
Paramètres
table 0-row-2 1-row-2 2-row-2
Paramètre Type
chaîne chaîne
suffixe chaîne
Signature et type renvoyé

endWith(<string>,<string>)

Renvoie une valeur booléenne.

Exemples

endWith("Hello World", "World")

Renvoie true.

endWith("Hello World", "Hello")

Renvoie false.

endWithIgnoreCase endWithIgnoreCase

Vérifie si la chaîne du premier argument se termine par une chaîne spécifique (chaîne du deuxième argument), sans tenir compte de la casse.

Syntaxe
endWithIgnoreCase(<parameters>)
Paramètres
table 0-row-2 1-row-2 2-row-2
Paramètre Type
chaîne chaîne
suffixe chaîne
Signature et type renvoyé

endWithIgnoreCase(<string>,<string>)

Renvoie une valeur booléenne.

Exemples

endWithIgnoreCase("rowing is great", "AT")

Renvoie true.

equalIgnoreCase equalIgnoreCase

Compare la chaîne du premier argument à la chaîne du deuxième argument, en ignorant les considérations de casse.

Syntaxe
equalIgnoreCase(<parameters>)
Paramètres
  • Chaîne
Signature et type renvoyé

equalIgnoreCase(<string>,<string>)

Renvoie une valeur booléenne.

Exemples

equalIgnoreCase("rowing is great", "rowing is GREAT")

Renvoie true.

indexOf indexOf

Renvoie la position (dans le premier argument) de la dernière occurrence du deuxième paramètre. Renvoie -1 s’il n’existe aucune correspondance.

Syntaxe
indexOf(<parameters>)
Paramètres
table 0-row-2 1-row-2 2-row-2
Paramètre Type
string Chaîne
valeur spécifiée Chaîne
Signature et type renvoyé

indexOf(<string>,<string>)

Renvoie un entier.

Exemples

indexOf("Hello", "l")

Renvoie 2.

Explication :

Dans « Hello », la première occurrence de « l » est à la position 2.

isEmpty isEmpty

Renvoie « true » si la chaîne du paramètre ne contient aucun caractère.

Syntaxe
isEmpty(<parameters>)
Paramètres
  • Chaîne
Signature et type renvoyé

isEmpty(<string>)

Renvoie une valeur booléenne.

Exemples

isEmpty("")

Renvoie true.

isEmpty("Hello World")

Renvoie false.

isNotEmpty isNotEmpty

Renvoie « true » si la chaîne du paramètre n’est pas vide.

Syntaxe
isNotEmpty(<parameters>)
Paramètres
  • Chaîne
Signature et type renvoyé

isNotEmpty(<string>)

Renvoie une valeur booléenne.

Exemples

isNotEmpty("")

Renvoie false.

isNotEmpty("hello")

Renvoie true.

lastIndexOf lastIndexOf

Renvoie la position (dans le premier argument) de la dernière occurrence du deuxième paramètre. Renvoie -1 s’il n’existe aucune correspondance.

Syntaxe
lastIndexOf(<parameters>)
Paramètre
table 0-row-2 1-row-2 2-row-2
Paramètre Type
string Chaîne
valeur spécifiée Chaîne
Signature et type renvoyé

lastIndexOf(<string>,<string>)

Renvoie un entier.

Exemples

lastIndexOf("Hello", "l")

Renvoie 3.

Explication :

Dans « Hello », la dernière occurrence de « l » est à la position 3.

length length

Renvoie le nombre de caractères de l’expression sous forme de chaîne dans le paramètre.

Syntaxe
length(<parameters>)
Paramètre
  • chaîne
Signature et type renvoyé

length(<string>)

Renvoie un entier.

Exemples

length("Hello World")

Renvoie 11.

lower lower

Renvoie une version en minuscules du paramètre.

Syntaxe
lower(<parameter>)
Paramètre
  • chaîne
Signature et type renvoyé

lower(<string>)

Renvoie une chaîne.

Exemples

lower("A")

Renvoie « a ».

matchRegExp matchRegExp

Renvoie « true » si la chaîne du premier paramètre correspond à l’expression régulière du second paramètre. Pour plus d’informations, consultez cette page.

Syntaxe
matchRegExp(<parameters>)
Paramètres
table 0-row-2 1-row-2 2-row-2
Paramètre Type
chaîne chaîne
regexp chaîne
Signature et type renvoyé

matchRegExp(<string>,<string>)

Renvoie une valeur booléenne.

Exemples

matchRegExp("12345", "\\d+")

Renvoie true.

notEqualIgnoreCase notEqualIgnoreCase

Vérifie si la chaîne du premier argument est différente de la chaîne du deuxième argument, en ignorant les considérations de casse.

Syntaxe
notEqualIgnoreCase(<parameters>)
Paramètres
  • Chaîne
Signature et type renvoyé

notEqualIgnoreCase(<string>,<string>)

Renvoie une valeur booléenne.

Exemples
notEqualIgnoreCase(@event{iOSPushPermissionAllowed.device.model}, "iPad")

replace replace

Remplace la première occurrence correspondant à la chaîne cible par la chaîne de remplacement dans la chaîne de base.

Le remplacement s’effectue du début à la fin de la chaîne. Par exemple, le remplacement de « aa » par « b » dans la chaîne « aaa » donnera « ba » et non « ab ».

Syntaxe
replace(<parameters>)
Paramètres
table 0-row-2 1-row-2 2-row-2 3-row-2
Paramètre Type
base chaîne
cible string (RegExp)
remplacement chaîne
Signature et type renvoyé

replace(<base>,<target>,<replacement>)

Renvoie une chaîne.

Exemples

replace("Hello World", "l", "x")

Renvoie « Hexlo World ».

Exemple avec RegExp:

Comme le paramètre cible est un RegExp, selon la chaîne que vous souhaitez remplacer, vous devrez peut-être ajouter une séquence d’échappement à certains caractères. Voici un exemple :

  • chaîne à évaluer : |OFFER_A|OFFER_B
  • fourni par un attribut de profil #{ExperiencePlatform.myFieldGroup.profile.myOffers}
  • Chaîne à remplacer : |OFFER_A
  • Chaîne remplacée par : ''
  • Vous devez ajouter \\ avant le caractère |.

L’expression est la suivante :

replace(#{ExperiencePlatform.myFieldGroup.profile.myOffers}, '\\|OFFER_A', '')

La chaîne renvoyée est la suivante : |OFFER_B

Vous pouvez également créer la chaîne à remplacer à partir d’un attribut donné :

replace(#{ExperiencePlatform.myFieldGroup.profile.myOffers}, '\\|' + #{ExperiencePlatform.myFieldGroup.profile.myOfferCode}, '')

replaceAll replaceAll

Remplace toutes les occurrences correspondant à la chaîne cible par la chaîne de remplacement dans la chaîne de base.

Le remplacement s’effectue du début à la fin de la chaîne. Par exemple, le remplacement de « aa » par « b » dans la chaîne « aaa » donnera « ba » et non « ab ».

Syntaxe
replaceAll(<parameters>)
Paramètres
table 0-row-2 1-row-2 2-row-2 3-row-2
Paramètre Type
base chaîne
cible string (RegExp)
remplacement chaîne
Signature et type renvoyé

replaceAll(<baseString>,<sourceString>,<replacementString>)

Renvoie une chaîne.

Exemples

replaceAll("Hello World", "l", "x")

Renvoie « Hexxo Worxd ».

Comme le paramètre cible est un RegExp, selon la chaîne que vous souhaitez remplacer, vous devrez peut-être ajouter une séquence d’échappement à certains caractères. Reportez-vous à l’exemple de la fonction replace.

split split

Partage la première chaîne d’arguments avec une chaîne de séparateur (deuxième chaîne d’arguments, qui peut être une expression régulière) pour produire une liste de chaînes (jetons).

Syntaxe
split(<parameters>)
Paramètres
table 0-row-2 1-row-2 2-row-2
Paramètre Type
chaîne d’entrée Chaîne
chaîne de séparateur Chaîne
Signatures et type renvoyé

split(<input string>, <separator string>)

Renvoie une fonction listString.

Exemples

split("A_B_C", "_")

Renvoie ["A","B","C"]

Exemple avec un champ d’événement 'event.appVersion' avec la valeur : « 20.45.2.3434 »

split(@event{event.appVersion}, "\\.")

Renvoie ["20", "45", "2", "3434"]

startWith startWith

Renvoie « true » si le deuxième paramètre est un préfixe du premier.

Syntaxe
startWith(<parameters>)
Paramètres
table 0-row-2 1-row-2 2-row-2
Paramètre Type
chaîne chaîne
préfixe chaîne
Signature et type renvoyé

startWith(<string>,<string>)

Renvoie une valeur booléenne.

Exemples

startWith("Hello World", "Hello")

Renvoie true.

startWith("Hello World", "World")

Renvoie false.

startWithIgnoreCase startWithIgnoreCase

Renvoie « true » si le deuxième paramètre est un préfixe du premier sans tenir compte de la casse.

Syntaxe
startWithIgnoreCase(<parameters>)
Paramètres
table 0-row-2 1-row-2 2-row-2
Paramètre Type
chaîne chaîne
préfixe chaîne
Signature et type renvoyé

startWithIgnoreCase(<string>,<string>)

Renvoie une valeur booléenne.

Exemples

startWithIgnoreCase("rowing is great", "RO")

Renvoie true.

substr substr

Renvoie la sous-chaîne de l’expression sous forme de chaîne entre l’index de début et l’index de fin. Si l’index de fin n’est pas défini, il se trouve entre l’index de début et la fin.

Syntaxe
substr(<parameters>)
Paramètres
table 0-row-2 1-row-2 2-row-2 3-row-2
Paramètre type
chaîne chaîne
beginIndex nombre entier
endIndex nombre entier
Signature et type renvoyé

substr(<string>,<beginIndex>)

substr(<string>,<beginIndex>,<endIndex>)

Renvoie une chaîne.

Exemples

substr("Hello World",6)

Renvoie « World ».

substr("Hello World", 0, 5)

Renvoie « Hello ».

trim trim

Supprime les espaces de début et de fin.

Syntaxe
trim(<parameters>)
Paramètre
table 0-row-2 1-row-2
Paramètre Type
chaîne Chaîne
Signature et type renvoyé

trim(<string>)

Renvoie une chaîne.

Exemples

trim(" Hello ")

Renvoie « Hello ».

upper upper

Renvoie une version en majuscules du paramètre.

Syntaxe
upper(<parameters>)
Signature et type renvoyé

upper(<string>)

Renvoie une chaîne.

Exemples

upper("b")

Renvoie « B ».

uuid uuid

Génère un UUID (Universal Unique Identifier) aléatoire.

Syntaxe
uuid()
Paramètres
Cette fonction ne requiert pas de paramètres.
Signature et type renvoyé

uuid()

Renvoie une chaîne.

Exemples

uuid()

Renvoie « 79e70b7f-8a85-400b-97a1-9f9826121553 ».

recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76