Profile Query Language (PQL) offre les fonctions pour rendre l'interaction avec les chaînes plus simple. Vous trouverez plus d'informations sur les autres fonctions PQL dans le Profile Query Language overview.
La fonction like
permet de déterminer si une chaîne correspond à un modèle donné.
Format
{STRING_1} like {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 _ .
|
Exemple
La requête PQL suivante récupère toutes les villes contenant le modèle « es ».
city like "%es%"
La fonction startsWith
permet de déterminer si une chaîne commence par une sous-chaîne donnée.
Format
{STRING_1}.startsWith({STRING_2}, {BOOLEAN})
Argument | Description |
---|---|
{STRING_1} |
La chaîne à vérifier. |
{STRING_2} |
La chaîne à rechercher dans la première chaîne. |
{BOOLEAN} |
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 PQL suivante détermine si le nom de la personne commence par « Joe » en respectant la casse.
person.name.startsWith("Joe")
La fonction doesNotStartWith
permet de déterminer si une chaîne ne commence pas par une sous-chaîne donnée.
Format
{STRING_1}.doesNotStartWith({STRING_2}, {BOOLEAN})
Argument | Description |
---|---|
{STRING_1} |
La chaîne à vérifier. |
{STRING_2} |
La chaîne à rechercher dans la première chaîne. |
{BOOLEAN} |
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 PQL suivante détermine si le nom de la personne ne commence pas par « Joe » en respectant la casse.
person.name.doesNotStartWith("Joe")
La fonction endsWith
permet de déterminer si une chaîne se termine par une sous-chaîne donnée.
Format
{STRING_1}.endsWith({STRING_2}, {BOOLEAN})
Argument | Description |
---|---|
{STRING_1} |
La chaîne à vérifier. |
{STRING_2} |
La chaîne à rechercher dans la première chaîne. |
{BOOLEAN} |
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 PQL suivante détermine si l’adresse électronique de la personne se termine par « .com » en respectant la casse.
person.emailAddress.endsWith(".com")
La fonction doesNotEndWith
permet de déterminer si une chaîne ne se termine pas par une sous-chaîne donnée.
Format
{STRING_1}.doesNotEndWith({STRING_2}, {BOOLEAN})
Argument | Description |
---|---|
{STRING_1} |
La chaîne à vérifier. |
{STRING_2} |
La chaîne à rechercher dans la première chaîne. |
{BOOLEAN} |
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 PQL suivante détermine si l’adresse électronique de la personne ne se termine pas par « .com » en respectant la casse.
person.emailAddress.doesNotEndWith(".com")
La fonction contains
permet de déterminer si une chaîne contient une sous-chaîne donnée.
Format
{STRING_1}.contains({STRING_2}, {BOOLEAN})
Argument | Description |
---|---|
{STRING_1} |
La chaîne à vérifier. |
{STRING_2} |
La chaîne à rechercher dans la première chaîne. |
{BOOLEAN} |
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 PQL suivante détermine si l’adresse électronique de la personne contient la chaîne « 2010@gm » en respectant la casse.
person.emailAddress.contains("2010@gm")
La fonction doesNotContain
permet de déterminer si une chaîne ne contient pas une sous-chaîne donnée.
Format
{STRING_1}.doesNotContain({STRING_2}, {BOOLEAN})
Argument | Description |
---|---|
{STRING_1} |
La chaîne à vérifier. |
{STRING_2} |
La chaîne à rechercher dans la première chaîne. |
{BOOLEAN} |
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 PQL suivante détermine si l’adresse électronique de la personne ne contient pas la chaîne « 2010@gm » en respectant la casse.
person.emailAddress.doesNotContain("2010@gm")
La fonction equals
permet de déterminer si une chaîne est égale à une sous-chaîne donnée.
Format
{STRING_1}.equals({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 PQL suivante détermine si le nom de la personne est « John » en respectant la casse.
person.name.equals("John")
La fonction notEqualTo
permet de déterminer si une chaîne est différente d’une chaîne donnée.
Format
{STRING_1}.notEqualTo({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 PQL suivante détermine si le nom de la personne n’est pas « John » en respectant la casse.
person.name.notEqualTo("John")
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
{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")
La fonction regexGroup
est utilisée pour extraire des informations spécifiques en fonction 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)
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.