Funzioni stringa
Profile Query Language (PQL) offre funzioni per semplificare l’interazione con le stringhe. Ulteriori informazioni su altre funzioni PQL sono disponibili nella Profile Query Language panoramica.
Mi piace
Il like
viene utilizzata per determinare se una stringa corrisponde a un pattern specificato.
Formato
{STRING_1} like {STRING_2}
{STRING_1}
{STRING_2}
Espressione da confrontare con la prima stringa. Per creare un’espressione sono disponibili due caratteri speciali supportati: %
e _
.
%
viene utilizzato per rappresentare zero o più caratteri._
viene utilizzato per rappresentare esattamente un carattere.
Esempio
La seguente query PQL recupera tutte le città contenenti il pattern "es".
city like "%es%"
Inizia con
Il startsWith
viene utilizzata per determinare se una stringa inizia con una sottostringa specificata.
Formato
{STRING_1}.startsWith({STRING_2}, {BOOLEAN})
{STRING_1}
{STRING_2}
{BOOLEAN}
Esempio
La seguente query PQL determina, con distinzione tra maiuscole e minuscole, se il nome della persona inizia con "Joe".
person.name.startsWith("Joe")
Non inizia con
Il doesNotStartWith
La funzione viene utilizzata per determinare se una stringa non inizia con una sottostringa specificata.
Formato
{STRING_1}.doesNotStartWith({STRING_2}, {BOOLEAN})
{STRING_1}
{STRING_2}
{BOOLEAN}
Esempio
La seguente query PQL determina, con distinzione tra maiuscole e minuscole, se il nome della persona non inizia con "Joe".
person.name.doesNotStartWith("Joe")
Termina con
Il endsWith
viene utilizzata per determinare se una stringa termina con una sottostringa specificata.
Formato
{STRING_1}.endsWith({STRING_2}, {BOOLEAN})
{STRING_1}
{STRING_2}
{BOOLEAN}
Esempio
La seguente query PQL determina, con distinzione tra maiuscole e minuscole, se l’indirizzo e-mail della persona termina con ".com".
person.emailAddress.endsWith(".com")
Non termina con
Il doesNotEndWith
La funzione viene utilizzata per determinare se una stringa non termina con una sottostringa specificata.
Formato
{STRING_1}.doesNotEndWith({STRING_2}, {BOOLEAN})
{STRING_1}
{STRING_2}
{BOOLEAN}
Esempio
La seguente query PQL determina, con distinzione tra maiuscole e minuscole, se l’indirizzo e-mail della persona non termina con ".com".
person.emailAddress.doesNotEndWith(".com")
Contains
Il contains
La funzione viene utilizzata per determinare se una stringa contiene una sottostringa specificata.
Formato
{STRING_1}.contains({STRING_2}, {BOOLEAN})
{STRING_1}
{STRING_2}
{BOOLEAN}
Esempio
La seguente query PQL determina, con distinzione tra maiuscole e minuscole, se l’indirizzo e-mail della persona contiene la stringa "2010@gm".
person.emailAddress.contains("2010@gm")
Non contiene
Il doesNotContain
La funzione viene utilizzata per determinare se una stringa non contiene una sottostringa specificata.
Formato
{STRING_1}.doesNotContain({STRING_2}, {BOOLEAN})
{STRING_1}
{STRING_2}
{BOOLEAN}
Esempio
La seguente query PQL determina, con distinzione tra maiuscole e minuscole, se l’indirizzo e-mail della persona non contiene la stringa "2010@gm".
person.emailAddress.doesNotContain("2010@gm")
È uguale a
Il equals
viene utilizzata per determinare se una stringa è uguale alla stringa specificata.
Formato
{STRING_1}.equals({STRING_2})
{STRING_1}
{STRING_2}
Esempio
La seguente query PQL determina, con distinzione tra maiuscole e minuscole, se il nome della persona è "John".
person.name.equals("John")
Diverso da
Il notEqualTo
viene utilizzata per determinare se una stringa non è uguale alla stringa specificata.
Formato
{STRING_1}.notEqualTo({STRING_2})
{STRING_1}
{STRING_2}
Esempio
La seguente query PQL determina, con distinzione tra maiuscole e minuscole, se il nome della persona non è "John".
person.name.notEqualTo("John")
Corrisponde
Il matches
viene utilizzata per determinare se una stringa corrisponde a una specifica espressione regolare. Fare riferimento a questo documento per ulteriori informazioni sui pattern corrispondenti nelle espressioni regolari, vedere.
Formato
{STRING_1}.matches(STRING_2})
Esempio
La seguente query PQL determina, senza distinzione tra maiuscole e minuscole, se il nome della persona inizia con "John".
person.name.matches("(?i)^John")
\w
, tu deve escape del carattere barra rovesciata. Quindi, invece di scrivere solo \w
, è necessario includere una barra rovesciata aggiuntiva e scrivere \\w
.Gruppo di espressioni regolari
Il regexGroup
La funzione viene utilizzata per estrarre informazioni specifiche, in base all’espressione regolare fornita.
Formato
{STRING}.regexGroup({EXPRESSION})
Esempio
La seguente query PQL viene utilizzata per estrarre il nome di dominio da un indirizzo e-mail.
emailAddress.regexGroup("@(\\w+)", 1)
\w
, tu deve escape del carattere barra rovesciata. Quindi, invece di scrivere solo \w
, è necessario includere una barra rovesciata aggiuntiva e scrivere \\w
.Passaggi successivi
Ora che hai imparato le funzioni stringa, puoi utilizzarle all’interno delle query PQL. Per ulteriori informazioni su altre funzioni PQL, leggere Panoramica sulla lingua delle query di profilo.