Fonctions de chaîne string

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

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) %}
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".

    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)%}
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 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)%}
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 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)%}
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 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) %}
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 à 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) %}
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 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) %}
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 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
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 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
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 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) %}
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 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) %}
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 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
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 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) %}
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 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
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 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) %}
NOTE
Lorsque l’expression utilisée comme second argument est un caractère RegEx spécial, utilisez une double barre oblique inverse (//). Les caractères RegEx spéciaux sont les suivants : [., +, *, ?, ^, $, (, ), [, ], {, }, |, ].
En savoir plus dans la documentation Oracle.

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) %}
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 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
recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76