Fonctions de chaîne
Profile Query Language (PQL) offre des fonctions permettant de simplifier l’interaction avec les chaînes. Vous trouverez plus d’informations sur d’autres fonctions de PQL dans la Profile Query Language présentation.
Comme
La fonction like permet de déterminer si une chaîne correspond à un modèle donné sous la forme d’une valeur booléenne.
Format
{STRING_1} like {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 PQL suivante récupère toutes les villes contenant le modèle « es ».
city like "%es%"
Commence par
La fonction startsWith permet de déterminer si une chaîne commence par une sous-chaîne donnée sous la forme d’une valeur booléenne.
Format
{STRING_1}.startsWith({STRING_2}, {BOOLEAN})
{STRING_1}{STRING_2}{BOOLEAN}Exemple
La requête PQL suivante détermine si le nom de la personne commence par « Joe » en respectant la casse.
person.name.startsWith("Joe")
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 sous la forme d’une valeur booléenne.
Format
{STRING_1}.doesNotStartWith({STRING_2}, {BOOLEAN})
{STRING_1}{STRING_2}{BOOLEAN}Exemple
La requête PQL suivante détermine si le nom de la personne ne commence pas par « Joe » en respectant la casse.
person.name.doesNotStartWith("Joe")
Se termine par
La fonction endsWith permet de déterminer si une chaîne se termine par une sous-chaîne donnée sous la forme d’une valeur booléenne.
Format
{STRING_1}.endsWith({STRING_2}, {BOOLEAN})
{STRING_1}{STRING_2}{BOOLEAN}Exemple
La requête PQL suivante détermine si l’adresse e-mail de la personne se termine par « .com » en respectant la casse.
person.emailAddress.endsWith(".com")
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 sous la forme d’une valeur booléenne.
Format
{STRING_1}.doesNotEndWith({STRING_2}, {BOOLEAN})
{STRING_1}{STRING_2}{BOOLEAN}Exemple
La requête PQL suivante détermine si l’adresse e-mail de la personne ne se termine pas par « .com » en respectant la casse.
person.emailAddress.doesNotEndWith(".com")
Contient
La fonction contains permet de déterminer si une chaîne contient une sous-chaîne donnée sous la forme d’une valeur booléenne.
Format
{STRING_1}.contains({STRING_2}, {BOOLEAN})
{STRING_1}{STRING_2}{BOOLEAN}Exemple
La requête PQL suivante détermine si l’adresse e-mail de la personne contient la chaîne « 2010@gm » en respectant la casse.
person.emailAddress.contains("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 en tant que valeur booléenne.
Format
{STRING_1}.doesNotContain({STRING_2}, {BOOLEAN})
{STRING_1}{STRING_2}{BOOLEAN}Exemple
La requête PQL suivante détermine si l’adresse e-mail de la personne ne contient pas la chaîne « 2010@gm » en respectant la casse.
person.emailAddress.doesNotContain("2010@gm")
Égal à
La fonction equals est utilisée pour déterminer si une chaîne est égale à la chaîne spécifiée sous la forme d’une valeur booléenne.
Format
{STRING_1}.equals({STRING_2})
{STRING_1}{STRING_2}Exemple
La requête PQL suivante détermine si le nom de la personne est « John » en respectant la casse.
person.name.equals("John")
Différent de
La fonction notEqualTo permet de déterminer si une chaîne est différente d’une chaîne booléenne donnée.
Format
{STRING_1}.notEqualTo({STRING_2})
{STRING_1}{STRING_2}Exemple
La requête PQL suivante détermine si le nom de la personne n’est pas « John » en respectant la casse.
person.name.notEqualTo("John")
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 sur les modèles correspondants dans les expressions régulières en tant que valeur booléenne.
Format
{STRING_1}.matches(STRING_2})
Exemple
La requête PQL suivante détermine si le nom de la personne commence par « John » sans tenir compte de la casse.
person.name.matches("(?i)^John")
\w, vous devez échapper le caractère barre oblique inverse. Ainsi, au lieu d’écrire uniquement \w, vous devez inclure une barre oblique inverse supplémentaire et \\w écrire.Groupe d’expressions régulières
La fonction regexGroup est utilisée pour extraire des informations spécifiques en fonction de l’expression régulière fournie sous la forme d’une chaîne.
Format
{STRING}.regexGroup({EXPRESSION})
Exemple
La requête PQL suivante est utilisée pour extraire le nom de domaine d’une adresse e-mail.
emailAddress.regexGroup("@(\\w+)", 1)
\w, vous devez échapper le caractère barre oblique inverse. Ainsi, au lieu d’écrire uniquement \w, vous devez inclure une barre oblique inverse supplémentaire et \\w écrire.Étapes suivantes
Maintenant que vous en savez plus sur les fonctions de chaîne, vous pouvez les utiliser dans vos requêtes PQL. Pour plus d’informations sur les autres fonctions PQL, consultez la présentation du langage de requête de profil.