Show Menu
SUJETS×

Fonctions de chaîne

Les offres PQL (Profil Requête Language) simplifient l’interaction avec les chaînes. Pour plus d'informations sur les autres fonctions PQL, consultez la présentation du langage Profil Requête.

J’aime

La like fonction est utilisée pour déterminer si une chaîne correspond à un modèle spécifié.
Format
{STRING_1} like {STRING_2}

Argument
Description
{STRING_1}
Chaîne sur laquelle effectuer la vérification.
{STRING_2}
expression à comparer à la première chaîne. Deux caractères spéciaux sont pris en charge pour créer une expression : % et _ .
  • % est utilisée pour représenter zéro ou plusieurs caractères.
  • _ est utilisé pour représenter exactement un caractère.
Exemple
La requête PQL suivante récupère toutes les villes contenant le modèle "es".
city like "%es%"

Commence par

La startsWith fonction est utilisée pour déterminer si une chaîne est début avec une sous-chaîne spécifiée.
Format
{STRING_1}.startsWith({STRING_2}, {BOOLEAN})

Argument
Description
{STRING_1}
Chaîne sur laquelle effectuer la vérification.
{STRING_2}
Chaîne à rechercher dans la première chaîne.
{BOOLEAN}
Paramètre facultatif permettant de déterminer si la vérification est sensible à la casse. Par défaut, cette valeur est définie sur true.
Exemple
La requête PQL suivante détermine, avec respect de la casse, si le nom de la personne est début avec "Joe".
person.name.startsWith("Joe")

Ne commence pas par

La doesNotStartWith fonction est utilisée pour déterminer si une chaîne ne se début pas avec une sous-chaîne spécifiée.
Format
{STRING_1}.doesNotStartWith({STRING_2}, {BOOLEAN})

Argument
Description
{STRING_1}
Chaîne sur laquelle effectuer la vérification.
{STRING_2}
Chaîne à rechercher dans la première chaîne.
{BOOLEAN}
Paramètre facultatif permettant de déterminer si la vérification est sensible à la casse. Par défaut, cette valeur est définie sur true.
Exemple
La requête PQL suivante détermine, avec respect de la casse, si le nom de la personne ne correspond pas à "Joe".
person.name.doesNotStartWith("Joe")

Se termine par

La endsWith fonction est utilisée pour déterminer si une chaîne se termine par une sous-chaîne spécifiée.
Format
{STRING_1}.endsWith({STRING_2}, {BOOLEAN})

Argument
Description
{STRING_1}
Chaîne sur laquelle effectuer la vérification.
{STRING_2}
Chaîne à rechercher dans la première chaîne.
{BOOLEAN}
Paramètre facultatif permettant de déterminer si la vérification est sensible à la casse. Par défaut, cette valeur est définie sur true.
Exemple
La requête PQL suivante détermine, avec respect de la casse, si l’adresse électronique de la personne se termine par ".com".
person.emailAddress.endsWith(".com")

Ne se termine pas par

La doesNotEndWith fonction permet de déterminer si une chaîne ne se termine pas par une sous-chaîne spécifiée.
Format
{STRING_1}.doesNotEndWith({STRING_2}, {BOOLEAN})

Argument
Description
{STRING_1}
Chaîne sur laquelle effectuer la vérification.
{STRING_2}
Chaîne à rechercher dans la première chaîne.
{BOOLEAN}
Paramètre facultatif permettant de déterminer si la vérification est sensible à la casse. Par défaut, cette valeur est définie sur true.
Exemple
La requête PQL suivante détermine, avec respect de la casse, si l’adresse électronique de la personne ne se termine pas par ".com".
person.emailAddress.doesNotEndWith(".com")

Contains (Contient)

La contains fonction est utilisée pour déterminer si une chaîne contient une sous-chaîne spécifiée.
Format
{STRING_1}.contains({STRING_2}, {BOOLEAN})

Argument
Description
{STRING_1}
Chaîne sur laquelle effectuer la vérification.
{STRING_2}
Chaîne à rechercher dans la première chaîne.
{BOOLEAN}
Paramètre facultatif permettant de déterminer si la vérification est sensible à la casse. Par défaut, cette valeur est définie sur true.
Exemple
La requête PQL suivante détermine, avec respect de la casse, si l’adresse électronique de la personne contient la chaîne "2010@gm".
person.emailAddress.contains("2010@gm")

Ne contient pas

La doesNotContain fonction permet de déterminer si une chaîne ne contient pas de sous-chaîne spécifiée.
Format
{STRING_1}.doesNotContain({STRING_2}, {BOOLEAN})

Argument
Description
{STRING_1}
Chaîne sur laquelle effectuer la vérification.
{STRING_2}
Chaîne à rechercher dans la première chaîne.
{BOOLEAN}
Paramètre facultatif permettant de déterminer si la vérification est sensible à la casse. Par défaut, cette valeur est définie sur true.
Exemple
La requête PQL suivante détermine, avec respect de la casse, si l’adresse électronique de la personne ne contient pas la chaîne "2010@gm".
person.emailAddress.doesNotContain("2010@gm")

Est égal

La equals fonction est utilisée pour déterminer si une chaîne est égale à la chaîne spécifiée.
Format
{STRING_1}.equals({STRING_2})

Argument
Description
{STRING_1}
Chaîne sur laquelle effectuer la vérification.
{STRING_2}
Chaîne à comparer à la première chaîne.
Exemple
La requête PQL suivante détermine, avec respect de la casse, si le nom de la personne est "John".
person.name.equals("John")

Différent de

La notEqualTo fonction permet de déterminer si une chaîne n’est pas égale à la chaîne spécifiée.
Format
{STRING_1}.notEqualTo({STRING_2})

Argument
Description
{STRING_1}
Chaîne sur laquelle effectuer la vérification.
{STRING_2}
Chaîne à comparer à la première chaîne.
Exemple
La requête PQL suivante détermine, avec respect de la casse, si le nom de la personne n’est pas "John".
person.name.notEqualTo("John")

Correspond à

La matches fonction permet de déterminer si une chaîne correspond à une expression régulière spécifique. Veuillez consulter ce document pour plus d'informations sur les modèles correspondants dans les expressions régulières.
Format
{STRING_1}.matches(STRING_2})

Exemple
La requête PQL suivante détermine, sans tenir compte de la casse, si le nom de la personne début avec "John".
person.name.matches("(?i)^John")

Groupe d'expressions régulières

La regexGroup fonction est utilisée pour extraire des informations spécifiques, sur la base de l'expression régulière fournie.
Format
{STRING}.regexGroup({EXPRESSION})

Exemple
La requête PQL suivante est utilisée pour extraire le nom de domaine d’une adresse électronique.
emailAddress.regexGroup("@(\w+)", 1)

Étapes suivantes

Maintenant que vous avez pris connaissance des fonctions de chaîne, vous pouvez les utiliser dans vos requêtes PQL. Pour plus d'informations sur d'autres fonctions PQL, veuillez lire la présentation de la langue de la Requête de Profil.