Fonctions de chaîne string-functions

concat(<string>,<string>)

concat(<listString>)

Renvoie une chaîne.

concat("Hello","World")

Renvoie « HelloWorld ».

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

Renvoie « Hello World ».

• chaîne

contain(<string>,<string>)

Renvoie une valeur booléenne.

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

Renvoie true.

containIgnoreCase(<string>,<string>)

Renvoie une valeur booléenne.

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

Renvoie true.

endWith(<string>,<string>)

Renvoie une valeur booléenne.

endWith("Hello World", "World")

Renvoie true.

endWith("Hello World", "Hello")

Renvoie false.

endWithIgnoreCase(<string>,<string>)

Renvoie une valeur booléenne.

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

Renvoie true.

• chaîne

equalIgnoreCase(<string>,<string>)

Renvoie une valeur booléenne.

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

Renvoie true.

indexOf(<string>,<string>)

Renvoie un entier.

indexOf("Hello", "l")

Renvoie 2.

Explication :

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

• chaîne

isEmpty(<string>)

Renvoie une valeur booléenne.

isEmpty("")

Renvoie true.

isEmpty("Hello World")

Renvoie false.

isEmpty(<null>)

Renvoie false.

• chaîne

isNotEmpty(<string>)

Renvoie une valeur booléenne.

isNotEmpty("")

Renvoie false.

isNotEmpty("hello")

Renvoie true.

lastIndexOf(<string>,<string>)

Renvoie un entier.

lastIndexOf("Hello", "l")

Renvoie 3.

Explication :

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

• chaîne

length(<string>)

Renvoie un entier.

length("Hello World")

Renvoie 11.

• chaîne

lower(<string>)

Renvoie une chaîne.

lower("A")

Renvoie « a ».

matchRegExp(<string>,<string>)

Renvoie une valeur booléenne.

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

Renvoie true.

• chaîne

notEqualIgnoreCase(<string>,<string>)

Renvoie une valeur booléenne.

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(<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(<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(<string>,<string>)

Renvoie une valeur booléenne.

startWith("Hello World", "Hello")

Renvoie true.

startWith("Hello World", "World")

Renvoie false.

startWithIgnoreCase(<string>,<string>)

Renvoie une valeur booléenne.

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

Renvoie true.

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

Renvoie une chaîne.

trim(" Hello ")

Renvoie « Hello ».

upper(<string>)

Renvoie une chaîne.

upper("b")

Renvoie « B ».

uuid()

Renvoie une chaîne.

uuid()

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

Cette section contient des connaissances structurées destinées à soutenir l’interprétation, la récupération et la réponse aux questions liées à ce sujet.

Pour une compréhension totale, ces informations doivent être combinées avec la documentation de cette page. Aucune des sources n’est conçue pour être autonome. La page décrit la fonctionnalité, tandis que cette section fournit un contexte supplémentaire qui permet de clarifier la terminologie, l’intention, l’applicabilité et les contraintes.

• TL;DR: Cette page documente toutes les fonctions de chaîne disponibles dans les expressions de parcours AJO, couvrant la recherche de texte, la comparaison, la transformation, l’extraction, la validation, le remplacement, le fractionnement et la génération d’identifiants uniques.

Intentions:

• Concaténer plusieurs chaînes à l’aide de concat
• Rechercher une sous-chaîne dans une chaîne (sensible à la casse ou non) à l’aide de contain ou containIgnoreCase
• Comparer deux chaînes en ignorant la casse à l’aide de equalIgnoreCase ou notEqualIgnoreCase
• Vérifiez si une chaîne commence ou se termine par un préfixe ou un suffixe spécifique en utilisant startWith, endWith et leurs variantes non sensibles à la casse
• Extraire une sous-chaîne par position d’index à l’aide de substr
• Remplacez la première ou toutes les occurrences d’un modèle dans une chaîne à l’aide de replace ou replaceAll
• Fractionner une chaîne en une liste de jetons à l’aide d’un séparateur utilisant split
• Générer un UUID aléatoire pour les besoins d’identifiant unique à l’aide de uuid
• Vérifier si une chaîne est vide ou non à l’aide de isEmpty ou isNotEmpty

Glossaire:

• RegExp : modèle d’expression régulière utilisé comme paramètre cible dans replace, replaceAll et matchRegExp - les caractères spéciaux doivent être précédés d’une séquence d’échappement \\
• UUID : identifiant unique universel — identifiant de chaîne généré de manière aléatoire et renvoyé par uuid()
• substr : extrait une partie d’une chaîne en spécifiant un index de début et un index de fin facultatif (basé sur zéro)

Mécanismes de sécurisation :

• Le paramètre target dans replace et replaceAll est traité comme un RegExp ; les caractères spéciaux (par exemple, |, .) doivent être précédés d’une séquence d’échappement avec \\
• replace remplace uniquement la première occurrence correspondante ; utilisez replaceAll pour remplacer chaque occurrence
• isEmpty renvoie false pour les valeurs nulles (non true) ; null n’est pas considéré comme une chaîne vide
• indexOf et lastIndexOf renvoient -1 lorsqu’aucune correspondance n’est trouvée
• Les positions d’index de chaîne sont basées sur zéro (le premier caractère est à la position 0)

Terminologie:

• Nom canonique : fonctions de chaîne — Acronyme : none — variantes : fonctions de texte, fonctions de manipulation de chaîne
• Synonymes : « contain » = « vérification de la sous-chaîne » ; « split » = « tokenize string » ; « trim » = « strip whitespace »
• Ne pas confondre : « replace » (première occurrence uniquement) ≠ « replaceAll » (toutes les occurrences)
• Ne pas confondre : « indexOf » (position de la première occurrence) ≠ « lastIndexOf » (position de la dernière occurrence)
• Ne les confondez pas : « isEmpty » (true uniquement pour les chaînes vides) ≠ vérification null (isEmpty renvoie false pour null)
• Ne pas confondre : « equalIgnoreCase » (renvoie true si égal ignore la casse) ≠ « notEqualIgnoreCase » (renvoie true si différent ignore la casse)

FAQ:

• Q : Comment puis-je vérifier si une chaîne contient une sous-chaîne indépendamment de la casse ? — Utilisez containIgnoreCase("myString", "searchTerm"), qui renvoie true si le terme de recherche est trouvé dans tous les cas.
• Q : Quelle est la différence entre replace et replaceAll ? — replace ne remplace que la première occurrence correspondante ; replaceAll remplace chaque occurrence de la chaîne.
• Q : Pourquoi dois-je échapper le caractère | dans replace ? — Le paramètre cible est traité comme une expression régulière ; | est un caractère RegExp spécial et doit être placé dans une séquence d’échappement comme \\| pour être traité comme une barre verticale.
• Q : Est-ce que isEmpty renvoie la valeur true pour null ? — Non, isEmpty renvoie false pour null ; il renvoie uniquement true pour une "" de chaîne de longueur nulle.
• Q : Comment extraire le numéro de version majeur d’une chaîne de version telle que « 20.45.2.3434 » ? — Utilisez getListItem(split(@event{event.appVersion}, "\\."), 0) pour fractionner par point et récupérer le premier élément.
• Q : Comment générer un identifiant unique dans une expression de parcours ? — Utilisez uuid(), qui renvoie une chaîne UUID générée de manière aléatoire sans paramètres requis.