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 :
- Concaténer et combiner plusieurs valeurs de texte (concat)
- Recherchez des modèles de texte ou des sous-chaînes spécifiques (contain, containIgnoreCase, indexOf, lastIndexOf, matchRegExp)
- Comparer des chaînes avec une correspondance sensible à la casse ou insensible à la casse (equalIgnoreCase, notEqualIgnoreCase)
- Vérifiez que la chaîne commence et se termine (startWith, startWithIgnoreCase, endWith, endWithIgnoreCase).
- Extraire des parties de texte à l’aide d’opérations de sous-chaîne (substr)
- Transformer le texte en majuscules ou en minuscules (majuscule, inférieure, rognage)
- Vérifiez si les chaînes sont vides ou contiennent des valeurs spécifiques (isEmpty, isNotEmpty)
- Remplacer des modèles de texte par de nouvelles valeurs (replace, replaceAll)
- Diviser les chaînes en tableaux pour un traitement ultérieur (division)
- Obtenir la longueur de la chaîne (length) ou générer les identifiants uniques (uuid)
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.
concat(<parameters>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Paramètre | Type |
| Liste | listString |
| chaîne | Chaîne |
concat(<string>,<string>)
concat(<listString>)
Renvoie une chaîne.
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.
contain(<parameters>)- Chaîne
contain(<string>,<string>)
Renvoie une valeur booléenne.
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.
containIgnoreCase(<parameters>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Paramètre | Type |
| chaîne | chaîne |
| chaîne recherchée | Chaîne |
containIgnoreCase(<string>,<string>)
Renvoie une valeur booléenne.
containIgnoreCase("rowing is great", "GREAT")
Renvoie true.
endWith endWith
Renvoie « true » si le deuxième paramètre est un suffixe du premier.
endWith(<parameters>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Paramètre | Type |
| chaîne | chaîne |
| suffixe | chaîne |
endWith(<string>,<string>)
Renvoie une valeur booléenne.
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.
endWithIgnoreCase(<parameters>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Paramètre | Type |
| chaîne | chaîne |
| suffixe | chaîne |
endWithIgnoreCase(<string>,<string>)
Renvoie une valeur booléenne.
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.
equalIgnoreCase(<parameters>)- Chaîne
equalIgnoreCase(<string>,<string>)
Renvoie une valeur booléenne.
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.
indexOf(<parameters>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Paramètre | Type |
| string | Chaîne |
| valeur spécifiée | Chaîne |
indexOf(<string>,<string>)
Renvoie un entier.
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.
isEmpty(<parameters>)- Chaîne
isEmpty(<string>)
Renvoie une valeur booléenne.
isEmpty("")
Renvoie true.
isEmpty("Hello World")
Renvoie false.
isNotEmpty isNotEmpty
Renvoie « true » si la chaîne du paramètre n’est pas vide.
isNotEmpty(<parameters>)- Chaîne
isNotEmpty(<string>)
Renvoie une valeur booléenne.
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.
lastIndexOf(<parameters>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Paramètre | Type |
| string | Chaîne |
| valeur spécifiée | Chaîne |
lastIndexOf(<string>,<string>)
Renvoie un entier.
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.
length(<parameters>)- chaîne
length(<string>)
Renvoie un entier.
length("Hello World")
Renvoie 11.
lower lower
Renvoie une version en minuscules du paramètre.
lower(<parameter>)- chaîne
lower(<string>)
Renvoie une chaîne.
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.
matchRegExp(<parameters>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Paramètre | Type |
| chaîne | chaîne |
| regexp | chaîne |
matchRegExp(<string>,<string>)
Renvoie une valeur booléenne.
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.
notEqualIgnoreCase(<parameters>)- Chaîne
notEqualIgnoreCase(<string>,<string>)
Renvoie une valeur booléenne.
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 ».
replace(<parameters>)| 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 |
replace(<base>,<target>,<replacement>)
Renvoie une chaîne.
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 ».
replaceAll(<parameters>)| 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 |
replaceAll(<baseString>,<sourceString>,<replacementString>)
Renvoie une chaîne.
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).
split(<parameters>)| 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 |
split(<input string>, <separator string>)
Renvoie une fonction listString.
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.
startWith(<parameters>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Paramètre | Type |
| chaîne | chaîne |
| préfixe | chaîne |
startWith(<string>,<string>)
Renvoie une valeur booléenne.
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.
startWithIgnoreCase(<parameters>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Paramètre | Type |
| chaîne | chaîne |
| préfixe | chaîne |
startWithIgnoreCase(<string>,<string>)
Renvoie une valeur booléenne.
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.
substr(<parameters>)| 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 |
substr(<string>,<beginIndex>)
substr(<string>,<beginIndex>,<endIndex>)
Renvoie une chaîne.
substr("Hello World",6)
Renvoie « World ».
substr("Hello World", 0, 5)
Renvoie « Hello ».
trim trim
Supprime les espaces de début et de fin.
trim(<parameters>)| table 0-row-2 1-row-2 | |
|---|---|
| Paramètre | Type |
| chaîne | Chaîne |
trim(<string>)
Renvoie une chaîne.
trim(" Hello ")
Renvoie « Hello ».
upper upper
Renvoie une version en majuscules du paramètre.
upper(<parameters>)upper(<string>)
Renvoie une chaîne.
upper("b")
Renvoie « B ».
uuid uuid
Génère un UUID (Universal Unique Identifier) aléatoire.
uuid()uuid()
Renvoie une chaîne.
uuid()
Renvoie « 79e70b7f-8a85-400b-97a1-9f9826121553 ».