Fonctions de chaîne string
Découvrez comment utiliser les fonctions de chaîne dans l’éditeur de personnalisation.
Casse mixte camelCase
La fonction camelCase met en majuscule la première lettre de chaque mot d'une chaîne.
Syntaxe
{%= camelCase(string)%}
Exemple
La fonction suivante met en majuscule la première lettre du mot de l'adresse postale du profil.
{%= camelCase(profile.homeAddress.street) %}
Char code at char-code-at
La fonction charCodeAt renvoie la valeur ASCII d’un caractère, comme la fonction charCodeAt dans JavaScript. Elle prend une chaîne et un entier (qui définissent la position du caractère) comme arguments d’entrée et renvoie sa valeur ASCII correspondante.
Syntaxe
{%= charCodeAt(string,int) %}: int
Exemple
La fonction suivante renvoie la valeur ASCII de o, c’est-à-dire 111.
{%= charCodeAt("some", 1)%}
Concat concate
La fonction concat combine deux chaînes en une seule.
Syntaxe
{%= concat(string,string) %}
Exemple
La fonction suivante combine la ville et le pays du profil dans une seule chaîne.
{%= concat(profile.homeAddress.city,profile.homeAddress.country) %}
Contient contains
La fonction contains permet de déterminer si une chaîne contient une sous-chaîne donnée.
Syntaxe
{%= contains(STRING_1, STRING_2, CASE_SENSITIVE) %}
STRING_1STRING_2CASE_SENSITIVEExemples
-
La fonction suivante vérifie si le prénom du profil contient la lettre A (en majuscule ou en minuscule). Si c'est le cas, elle renverra "true", sinon elle renverra "false".
code language-sql {%= contains(profile.person.name.firstName, "A", false) %} -
La requête suivante détermine si l'adresse e-mail de la personne contient la chaîne « 2010@gm » en respectant la casse.
code language-sql {%= contains(profile.person.emailAddress,"2010@gm") %}
Ne contient pas doesNotContain
La fonction doesNotContain permet de déterminer si une chaîne ne contient pas une sous-chaîne donnée.
Syntaxe
{%= doesNotContain(STRING_1, STRING_2, CASE_SENSITIVE)%}
STRING_1STRING_2CASE_SENSITIVEExemple
La requête suivante détermine si l'adresse e-mail de la personne ne contient pas la chaîne « 2010@gm » en respectant la casse.
{%= doesNotContain(profile.person.emailAddress,"2010@gm")%}
Ne se termine pas par doesNotEndWith
La fonction doesNotEndWith permet de déterminer si une chaîne ne se termine pas par une sous-chaîne donnée.
Syntaxe
{%= doesNotEndWith(STRING_1, STRING_2, CASE_SENSITIVE)%}
{STRING_1}{STRING_2}{CASE_SENSITIVE}Exemple
La requête suivante détermine si l'adresse e-mail de la personne ne se termine pas par « .com » en respectant la casse.
doesNotEndWith(person.emailAddress,".com")
Ne commence pas par doesNotStartWith
La fonction doesNotStartWith permet de déterminer si une chaîne ne commence pas par une sous-chaîne donnée.
Syntaxe
{%= doesNotStartWith(STRING_1, STRING_2, CASE_SENSITIVE)%}
{STRING_1}{STRING_2}{CASE_SENSITIVE}Exemple
La requête suivante détermine si le nom de la personne ne commence pas par « Joe » en respectant la casse.
{%= doesNotStartWith(person.name,"Joe")%}
Encode 64 encode64
La fonction encode64 est utilisée pour coder une chaîne afin de conserver les informations personnelles (PI) si elles doivent être incluses, par exemple, dans une URL.
Syntaxe
{%= encode64(string) %}
Se termine par endsWith
La fonction endsWith permet de déterminer si une chaîne se termine par une sous-chaîne donnée.
Syntaxe
{%= endsWith(STRING_1, STRING_2, CASE_SENSITIVE) %}
{STRING_1}{STRING_2}{CASE_SENSITIVE}Exemple
La requête suivante détermine si l'adresse e-mail de la personne se termine par « .com » en respectant la casse.
{%= endsWith(person.emailAddress,".com") %}
Égal à equals
La fonction equals permet de déterminer si une chaîne est égale à une chaîne donnée, en respectant la casse.
Syntaxe
{%= equals(STRING_1, STRING_2) %}
{STRING_1}{STRING_2}Exemple
La requête suivante détermine si le nom de la personne est « John » en respectant la casse.
{%=equals(profile.person.name,"John") %}
Égal à ignorer la casse equalsIgnoreCase
La fonction equalsIgnoreCase permet de déterminer si une chaîne est égale à la chaîne donnée, en respectant la casse.
Syntaxe
{%= equalsIgnoreCase(STRING_1, STRING_2) %}
{STRING_1}{STRING_2}Exemple
La requête suivante détermine si le nom de la personne est « John » sans respect de la casse.
{%= equalsIgnoreCase(profile.person.name,"John") %}
Extraire le domaine e-mail extractEmailDomain
La fonction extractEmailDomain permet d'extraire le domaine d'une adresse e-mail.
Syntaxe
{%= extractEmailDomain(string) %}
Exemple
La requête suivante extrait le domaine de l'adresse e-mail personnelle.
{%= extractEmailDomain(profile.personalEmail.address) %}
Format currency format-currency
La fonction formatCurrency est utilisée pour convertir n’importe quel nombre en sa représentation monétaire sensible à la langue correspondante en fonction des paramètres régionaux transmis sous forme de chaîne dans le deuxième argument.
Syntaxe
{%= formatCurrency(number/double,string) %}: string
Exemple
Cette requête renvoie 56.00 £.
{%= formatCurrency(56L,"en_GB") %}
Obtenir l’hôte d’URL get-url-host
La fonction getUrlHost sert à récupérer le nom d’hôte d’une URL.
Syntaxe
{%= getUrlHost(string) %}: string
Exemple
{%= getUrlHost("https://www.myurl.com/contact") %}
Renvoie « www.myurl.com »
Obtenir le chemin d’accès à l’URL get-url-path
La fonction getUrlPath sert à récupérer le chemin d’accès d’après le nom de domaine d’une URL.
Syntaxe
{%= getUrlPath(string) %}: string
Exemple
{%= getUrlPath("https://www.myurl.com/contact.html") %}
Renvoie « /contact.html »
Obtenir le protocole d’URL get-url-protocol
La fonction getUrlProtocol est utilisée pour récupérer le protocole d’une URL.
Syntaxe
{%= getUrlProtocol(string) %}: string
Exemple
{%= getUrlProtocol("https://www.myurl.com/contact.html") %}
Renvoie « http »
Index de index-of
La fonction indexOf est utilisée pour renvoyer la position (dans le premier argument) de la première occurrence du deuxième paramètre. Renvoie -1 s’il n’existe aucune correspondance.
Syntaxe
{%= indexOf(STRING_1, STRING_2) %}: integer
{STRING_1}{STRING_2}Exemple
{%= indexOf("hello world","world" ) %}
Renvoie 6.
Est vide isEmpty
La fonction isEmpty permet de déterminer si une chaîne contient une chaîne est vide.
Syntaxe
{%= isEmpty(string) %}
Exemple
La fonction suivante renvoie "true" si le numéro de téléphone mobile du profil est vide. Sinon, elle renverra "false".
{%= isEmpty(profile.mobilePhone.number) %}
N’est pas vide is-not-empty
La fonction isNotEmpty sert à déterminer si une chaîne n’est pas vide.
Syntaxe
{= isNotEmpty(string) %}: boolean
Exemple
La fonction suivante renvoie "true" si le numéro de téléphone mobile du profil n’est pas vide. Sinon, elle renverra "false".
{%= isNotEmpty(profile.mobilePhone.number) %}
Dernier index de last-index-of
La fonction lastIndexOf est utilisée pour renvoyer 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(STRING_1, STRING_2) %}: integer
{STRING_1}{STRING_2}Exemple
{%= lastIndexOf("hello world","o" ) %}
Renvoie 7.
Supprimer à gauche leftTrim
La fonction leftTrim est utilisée pour supprimer les espaces blancs au début d'une chaîne.
Syntaxe
{%= leftTrim(string) %}
Longueur length
La fonction length est utilisée pour obtenir le nombre de caractères d'une chaîne ou d'une expression.
Syntaxe
{%= length(string) %}
Exemple
La fonction suivante renvoie la longueur du nom de ville du profil.
{%= length(profile.homeAddress.city) %}
Comme like
La fonction like permet de déterminer si une chaîne correspond à un modèle donné.
Syntaxe
{%= like(STRING_1, STRING_2) %}
{STRING_1}{STRING_2}L'expression à laquelle comparer la première chaîne. Les deux caractères spéciaux pris en charge pour créer une expression sont % et _.
%est utilisé pour représenter aucun ou plusieurs caractères._est utilisé pour représenter exactement un caractère.
Exemple
La requête suivante récupère toutes les villes où vivent les profils contenant le modèle ''es''.
{%= like(profile.homeAddress.city, "%es%")%}
Minuscules lower
La fonction lowerCase convertit une chaîne en minuscules.
Syntaxe
{%= lowerCase(string) %}
Exemple
Cette fonction convertit le prénom du profil en minuscules.
{%= lowerCase(profile.person.name.firstName) %}
Correspond à matches
La fonction matches permet de déterminer si une chaîne correspond à une expression régulière donnée. Reportez-vous à ce document pour plus d'informations concernant les modèles correspondants dans les expressions régulières.
Syntaxe
{%= matches(STRING_1, STRING_2) %}
Exemple
La requête suivante détermine si le nom de la personne commence par « John » sans respect de la casse.
{%= matches(person.name.,"(?i)^John") %}
Masque mask
La fonction Mask est utilisée pour remplacer une partie d’une chaîne par des caractères « X ».
Syntaxe
{%= mask(string,integer,integer) %}
Exemple
La requête suivante remplace la chaîne « 123456789 » par des caractères « X », à l’exception des deux premiers et derniers caractères.
{%= mask("123456789",1,2) %}
La requête renvoie 1XXXXXX89.
MD5 md5
La fonction md5 est utilisée pour calculer et renvoyer le hachage md5 d’une chaîne.
Syntaxe
{%= md5(string) %}: string
Exemple
{%= md5("hello world") %}
Renvoie « 5eb63bbe01eeed093cb22bb8f5acdc3 »
Différent de notEqualTo
La fonction notEqualTo permet de déterminer si une chaîne est différente d'une chaîne donnée.
Syntaxe
{%= notEqualTo(STRING_1, STRING_2) %}
{STRING_1}{STRING_2}Exemple
La requête suivante détermine si le nom de la personne n'est pas « John » en respectant la casse.
{%= notEqualTo(profile.person.name,"John") %}
Différent de Ignorer la casse not-equal-with-ignore-case
La fonction notEqualWithIgnoreCase sert à comparer deux chaînes qui ne respectent pas la casse.
Syntaxe
{= notEqualWithIgnoreCase(STRING_1,STRING_2) %}: boolean
{STRING_1}{STRING_2}Exemple
La requête suivante détermine si le nom de la personne n’est pas « john » sans respect de la casse.
{%= notEqualTo(profile.person.name,"john") %}
Groupe d’expressions régulières regexGroup
La fonction Group est utilisée pour extraire des informations spécifiques en fonction de l'expression régulière fournie.
Syntaxe
{%= regexGroup(STRING, EXPRESSION, GROUP) %}
{STRING}{EXPRESSION}{GROUP}Exemple
La requête suivante est utilisée pour extraire le nom de domaine d'une adresse e-mail.
{%= regexGroup(emailAddress,"@(\\w+)", 1) %}
Remplacer replace
La fonction replace permet de remplacer une sous-chaîne donnée dans une chaîne par une autre sous-chaîne.
Syntaxe
{%= replace(STRING_1,STRING_2,STRING_3) %}:string
{STRING_1}{STRING_2}{STRING_3}Exemple
{%= replace("Hello John, here is your monthly newsletter!","John","Mark") %}
Renvoie « Bonjour Marc, voici votre newsletter mensuelle ! »
Tout remplacer replaceAll
La fonction replaceAll permet de remplacer toutes les sous-chaînes d’un texte correspondant à l’expression « RegEx » par la chaîne littérale de « remplacement » spécifiée. Les expressiones régulières (RegEx) ont une gestion spéciale de « \ » et « + », et toutes les expressions RegEx suivent la stratégie d’échappement PQL. 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(string,string,string) %}
//). Les caractères RegEx spéciaux sont les suivants : [., +, *, ?, ^, $, (, ), [, ], {, }, |, ].Supprimer à droite rightTrim
La fonction rightTrim est utilisée pour supprimer les espaces blancs de la fin d'une chaîne.
Syntaxe
{%= rightTrim(string) %}
Fractionner split
La fonction split est utilisée pour fractionner une chaîne selon un caractère donné.
Syntaxe
{%= split(string,string) %}
Commence par startsWith
La fonction startsWith permet de déterminer si une chaîne commence par une sous-chaîne donnée.
Syntaxe
{%= startsWith(STRING_1, STRING_2, CASE_SENSITIVE) %}
{STRING_1}{STRING_2}{CASE_SENSITIVE}Exemple
La requête suivante détermine si le nom de la personne commence par « Joe » en respectant la casse.
{%= startsWith(person.name,"Joe") %}
Chaîne en date string-to-date
La fonction stringToDate convertit une valeur de chaîne en valeur date / heure. Elle comporte deux arguments : représentation sous forme de chaîne d’une date et d’une heure et sous forme de chaîne du formateur.
Syntaxe
{= stringToDate("date-time value","formatter" %}
Exemple
{= stringToDate("2023-01-10 23:13:26", "yyyy-MM-dd HH:mm:ss") %}
Chaîne en entier string-to-integer
La fonction string_to_integer est utilisée pour convertir une valeur de chaîne en valeur entière.
Syntaxe
{= string_to_integer(string) %}: int
Chaîne en nombre string-to-number
La fonction stringToNumber est utilisée pour convertir une chaîne en nombre. Elle renvoie la même chaîne que la sortie pour une entrée non valide.
Syntaxe
{%= stringToNumber(string) %}: double
Sous-chaîne sub-string
La fonction Count string est utilisée pour renvoyer la sous-chaîne de l’expression de chaîne entre l’index de début et l’index de fin.
Syntaxe
{= substr(string, integer, integer) %}: string
Casse du titre titleCase
La fonction titleCase permet de mettre en majuscules les premières lettres de chaque mot d'une chaîne.
Syntaxe
{%= titleCase(string) %}
Exemple
Si la personne vit dans Washington high street, cette fonction renverra Washington High Street.
{%= titleCase(profile.person.location.Street) %}
En valeur booléenne to-bool
La fonction toBool est utilisée pour convertir une valeur d’argument en valeur booléenne, selon son type.
Syntaxe
{= toBool(string) %}: boolean
En date/heure to-date-time
La fonction toDateTime est utilisée pour convertir une chaîne en date. Elle renvoie la date de l’époque comme sortie pour une entrée non valide.
Syntaxe
{%= toDateTime(string, string) %}: date-time
To Date Time Only to-date-time-only
La fonction toDateTimeOnly est utilisée pour convertir une valeur d’argument en une valeur de date et d’heure uniquement. Elle renvoie la date de l’époque comme sortie pour une entrée non valide. Cette fonction accepte les types de champs chaîne, date, long et int.
Syntaxe
{%= toDateTimeOnly(string/date/long/int) %}: date-time
Taille trim
La fonction trim supprime tous les espaces blancs du début et de la fin d'une chaîne.
Syntaxe
{%= trim(string) %}
Majuscules upper
La fonction upperCase convertit une chaîne en majuscules.
Syntaxe
{%= upperCase(string) %}
Exemple
Cette fonction convertit le nom du profil en majuscules.
{%= upperCase(profile.person.name.lastName) %}
Décodage de l’URL url-decode
La fonction urlDecode est utilisée pour décoder une chaîne codée en URL.
Syntaxe
{%= urlDecode(string) %}: string
Encodage de l’URL url-encode
La fonction Count only null est utilisée pour encoder une chaîne en URL.
Syntaxe
{%= urlEncode(string) %}: string