Fonctions de chaîne

Découvrez comment utiliser les fonctions de chaîne dans l'éditeur d'expression.

Casse mixte

La fonction camelCase met en majuscule la première lettre de chaque mot d'une chaîne.

Format

{%= 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) %}

Concat

La fonction concat combine deux chaînes en une seule.

Format

{%= 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

La fonction contains permet de déterminer si une chaîne contient une sous-chaîne donnée.

Format

{%= contains(STRING_1, STRING_2, CASE_SENSITIVE) %}
Argument Description
STRING_1 La chaîne à vérifier.
STRING_2 La chaîne à rechercher dans la première chaîne.
CASE_SENSITIVE Un paramètre facultatif permettant de déterminer si la vérification est sensible à la casse. Valeurs possibles : true (par défaut)/false.

Exemples

  • 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".

    {%= 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.

    {%= contains(profile.person.emailAddress,"2010@gm") %}
    

Ne contient pas

La fonction doesNotContain permet de déterminer si une chaîne ne contient pas une sous-chaîne donnée.

Format

{%= doesNotContain(STRING_1, STRING_2, CASE_SENSITIVE)%}
Argument Description
STRING_1 La chaîne à vérifier.
STRING_2 La chaîne à rechercher dans la première chaîne.
CASE_SENSITIVE Un paramètre facultatif permettant de déterminer si la vérification est sensible à la casse. Valeurs possibles : true (par défaut)/false.

Exemple

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

La fonction doesNotEndWith permet de déterminer si une chaîne ne se termine pas par une sous-chaîne donnée.

Format

{%= doesNotEndWith(STRING_1, STRING_2, CASE_SENSITIVE)%}
Argument Description
{STRING_1} La chaîne à vérifier.
{STRING_2} La chaîne à rechercher dans la première chaîne.
{CASE_SENSITIVE} Un paramètre facultatif permettant de déterminer si la vérification est sensible à la casse. Valeurs possibles : true (par défaut)/false.

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

La fonction doesNotStartWith permet de déterminer si une chaîne ne commence pas par une sous-chaîne donnée.

Format

{%= doesNotStartWith(STRING_1, STRING_2, CASE_SENSITIVE)%}
Argument Description
{STRING_1} La chaîne à vérifier.
{STRING_2} La chaîne à rechercher dans la première chaîne.
{CASE_SENSITIVE} Un paramètre facultatif permettant de déterminer si la vérification est sensible à la casse. Valeurs possibles : true (par défaut)/false.

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

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.

Format

{%= encode64(string) %}

Se termine par

La fonction endsWith permet de déterminer si une chaîne se termine par une sous-chaîne donnée.

Format

{%= endsWith(STRING_1, STRING_2, CASE_SENSITIVE) %}
Argument Description
{STRING_1} La chaîne à vérifier.
{STRING_2} La chaîne à rechercher dans la première chaîne.
{CASE_SENSITIVE} Un paramètre facultatif permettant de déterminer si la vérification est sensible à la casse. Valeurs possibles : true (par défaut)/false.

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 à

La fonction equals permet de déterminer si une chaîne est égale à une chaîne donnée, en respectant la casse.

Format

{%= equals(STRING_1, STRING_2) %}
Argument Description
{STRING_1} La chaîne à vérifier.
{STRING_2} La chaîne à comparer à la première chaîne.

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

La fonction equalsIgnoreCase permet de déterminer si une chaîne est égale à la chaîne donnée, en respectant la casse.

Format

{%= equalsIgnoreCase(STRING_1, STRING_2) %}
Argument Description
{STRING_1} La chaîne à vérifier.
{STRING_2} La chaîne à comparer à la première chaîne.

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

La fonction extractEmailDomain permet d'extraire le domaine d'une adresse e-mail.

Format

{%= extractEmailDomain(string) %}

Exemple

La requête suivante extrait le domaine de l'adresse e-mail personnelle.

{%= extractEmailDomain(profile.personalEmail.address) %}

Obtenir l’hôte d’URL

La fonction getUrlHost sert à récupérer le nom d’hôte d’une URL.

Format

{%= getUrlHost(string) %}: string

Exemple

{%= getUrlHost("http://www.myurl.com/contact") %}

Renvoie « www.myurl.com »

Obtenir le chemin d’accès à l’URL

La fonction getUrlPath sert à récupérer le chemin d’accès d’après le nom de domaine d’une URL.

Format

{%= getUrlPath(string) %}: string

Exemple

{%= getUrlPath("http://www.myurl.com/contact.html") %}

Renvoie « /contact.html »

Obtenir le protocole d’URL

La fonction getUrlProtocol est utilisée pour récupérer le protocole d’une URL.

Format

{%= getUrlProtocol(string) %}: string

Exemple

{%= getUrlProtocol("http://www.myurl.com/contact.html") %}

Renvoie « http »

Index de

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.

Format

{%= indexOf(STRING_1, STRING_2) %}: integer
Argument Description
{STRING_1} La chaîne à vérifier.
{STRING_2} Chaîne à rechercher dans le premier paramètre

Exemple

{%= indexOf("hello world","world" ) %}

Renvoie 6.

Est vide

La fonction isEmpty permet de déterminer si une chaîne contient une chaîne est vide.

Format

{%= 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

La fonction isNotEmpty sert à déterminer si une chaîne n’est pas vide.

Format

{= 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

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.

Format

{= lastIndexOf(STRING_1, STRING_2) %}: integer
Argument Description
{STRING_1} La chaîne à vérifier.
{STRING_2} Chaîne à rechercher dans le premier paramètre

Exemple

{%= lastIndexOf("hello world","o" ) %}

Renvoie 7.

Supprimer à gauche

La fonction leftTrim est utilisée pour supprimer les espaces blancs au début d'une chaîne.

Format

{%= leftTrim(string) %}

Longueur

La fonction length est utilisée pour obtenir le nombre de caractères d'une chaîne ou d'une expression.

Format

{%= length(string) %}

Exemple

La fonction suivante renvoie la longueur du nom de ville du profil.

{%= length(profile.homeAddress.city) %}

Comme

La fonction like permet de déterminer si une chaîne correspond à un modèle donné.

Format

{%= like(STRING_1, STRING_2) %}
Argument Description
{STRING_1} La chaîne à vérifier.
{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

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 à

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.

Format

{%= 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 ».

Format

{%= 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

La fonction md5 est utilisée pour calculer et renvoyer le hachage md5 d’une chaîne.

Format

{%= md5(string) %}: string

Exemple

{%= md5("hello world") %}

Renvoie « 5eb63bbe01eeed093cb22bb8f5acdc3 »

Différent de

La fonction notEqualTo permet de déterminer si une chaîne est différente d'une chaîne donnée.

Format

{%= notEqualTo(STRING_1, STRING_2) %}
Argument Description
{STRING_1} La chaîne à vérifier.
{STRING_2} La chaîne à comparer à la première chaîne.

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

La fonction notEqualWithIgnoreCase sert à comparer deux chaînes qui ne respectent pas la casse.

Format

{= notEqualWithIgnoreCase(STRING_1,STRING_2) %}: boolean
Argument Description
{STRING_1} La chaîne à vérifier.
{STRING_2} La chaîne à comparer à la première chaîne.

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

La fonction Group est utilisée pour extraire des informations spécifiques en fonction de l'expression régulière fournie.

Format

{%= regexGroup(STRING, EXPRESSION, GROUP) %}
Argument Description
{STRING} La chaîne à vérifier.
{EXPRESSION} L'expression régulière avec laquelle comparer la première chaîne.
{GROUP} Groupe d'expressions à comparer.

Exemple

La requête suivante est utilisée pour extraire le nom de domaine d'une adresse e-mail.

{%= regexGroup(emailAddress,"@(\w+)", 1) %}

Remplacer

La fonction replace permet de remplacer une sous-chaîne donnée dans une chaîne par une autre sous-chaîne.

Format

{%= replace(STRING_1,STRING_2,STRING_3) %}:string
Argument Description
{STRING_1} Chaîne dans laquelle la sous-chaîne doit être remplacée.
{STRING_2} Sous-chaîne à remplacer.
{STRING_3} Sous-chaîne de remplacement.

Exemple

{%= replace("Hello John, here is your monthly newsletter!","John","Mark") %}

Renvoie « Bonjour Marc, voici votre newsletter mensuelle ! »

Tout remplacer

La fonction replaceAll permet de remplacer toutes les sous-chaînes d'un texte correspondant à la "cible" par la chaîne littérale de "remplacement" spécifiée. 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 ».

Format

{%= replaceAll(string,string,string) %}

Supprimer à droite

La fonction rightTrim est utilisée pour supprimer les espaces blancs de la fin d'une chaîne.

Format

{%= rightTrim(string) %}

Fractionner

La fonction split est utilisée pour fractionner une chaîne selon un caractère donné.

Format

{%= split(string,string) %}

Commence par

La fonction startsWith permet de déterminer si une chaîne commence par une sous-chaîne donnée.

Format

{%= startsWith(STRING_1, STRING_2, CASE_SENSITIVE) %}
Argument Description
{STRING_1} La chaîne à vérifier.
{STRING_2} La chaîne à rechercher dans la première chaîne.
{CASE_SENSITIVE} Un paramètre facultatif permettant de déterminer si la vérification est sensible à la casse. Par défaut, cette valeur est définie sur vraie.

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 entier

La fonction string_to_integer est utilisée pour convertir une valeur de chaîne en valeur entière.

Format

{= string_to_integer(string) %}: int

Chaîne en nombre

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.

Format

{%= stringToNumber(string) %}: double

Sous-chaîne

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.
Format

{= substr(string, integer, integer) %}: string

Casse du titre

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

La fonction toBool est utilisée pour convertir une valeur d’argument en valeur booléenne, selon son type.

Format

{= toBool(string) %}: boolean

En date/heure

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.

Format

{%= toDateTime(string, string) %}: date-time

En date/heure uniquement

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.

Format

{%= toDateTimeOnly(string) %}: date-time

Taille

La fonction trim supprime tous les espaces blancs du début et de la fin d'une chaîne.

Syntaxe

{%= trim(string) %}

Majuscules

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

La fonction urlDecode est utilisée pour décoder une chaîne codée en URL.

Format

{%= urlDecode(string) %}: string

Encodage de l’URL

La fonction Count only null est utilisée pour encoder une chaîne en URL.

Format

{%= urlEncode(string) %}: string

Sur cette page