Funzioni stringa
Profile Query Language (PQL) offre funzioni che semplificano l'interazione con le stringhe. Ulteriori informazioni sulle altre funzioni PQL sono disponibili nella Profile Query Language panoramica.
Simile
La funzione like viene utilizzata per determinare se una stringa corrisponde a un pattern specificato.
Formato
{STRING_1} like {STRING_2}
| Argomento | Descrizione |
|---|---|
{STRING_1} |
Stringa su cui eseguire il controllo. |
{STRING_2} |
L'espressione da confrontare con la prima stringa. Esistono due caratteri speciali supportati per la creazione di un'espressione: % e _.
|
Esempio
La seguente query PQL recupera tutte le città contenenti il pattern "es".
city like "%es%"
Inizia con
La funzione startsWith viene utilizzata per determinare se una stringa inizia con una sottostringa specificata.
Formato
{STRING_1}.startsWith({STRING_2}, {BOOLEAN})
| Argomento | Descrizione |
|---|---|
{STRING_1} |
Stringa su cui eseguire il controllo. |
{STRING_2} |
Stringa da cercare all'interno della prima stringa. |
{BOOLEAN} |
Un parametro facoltativo per determinare se il controllo è basato sulla distinzione tra maiuscole e minuscole. Per impostazione predefinita, è impostata su true. |
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
La funzione doesNotStartWith viene utilizzata per determinare se una stringa non inizia con una sottostringa specificata.
Formato
{STRING_1}.doesNotStartWith({STRING_2}, {BOOLEAN})
| Argomento | Descrizione |
|---|---|
{STRING_1} |
Stringa su cui eseguire il controllo. |
{STRING_2} |
Stringa da cercare all'interno della prima stringa. |
{BOOLEAN} |
Un parametro facoltativo per determinare se il controllo è basato sulla distinzione tra maiuscole e minuscole. Per impostazione predefinita, è impostata su true. |
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
La funzione endsWith viene utilizzata per determinare se una stringa termina con una sottostringa specificata.
Formato
{STRING_1}.endsWith({STRING_2}, {BOOLEAN})
| Argomento | Descrizione |
|---|---|
{STRING_1} |
Stringa su cui eseguire il controllo. |
{STRING_2} |
Stringa da cercare all'interno della prima stringa. |
{BOOLEAN} |
Un parametro facoltativo per determinare se il controllo è basato sulla distinzione tra maiuscole e minuscole. Per impostazione predefinita, è impostata su true. |
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
La funzione doesNotEndWith viene utilizzata per determinare se una stringa non termina con una sottostringa specificata.
Formato
{STRING_1}.doesNotEndWith({STRING_2}, {BOOLEAN})
| Argomento | Descrizione |
|---|---|
{STRING_1} |
Stringa su cui eseguire il controllo. |
{STRING_2} |
Stringa da cercare all'interno della prima stringa. |
{BOOLEAN} |
Un parametro facoltativo per determinare se il controllo è basato sulla distinzione tra maiuscole e minuscole. Per impostazione predefinita, è impostata su true. |
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
La funzione contains viene utilizzata per determinare se una stringa contiene una sottostringa specificata.
Formato
{STRING_1}.contains({STRING_2}, {BOOLEAN})
| Argomento | Descrizione |
|---|---|
{STRING_1} |
Stringa su cui eseguire il controllo. |
{STRING_2} |
Stringa da cercare all'interno della prima stringa. |
{BOOLEAN} |
Un parametro facoltativo per determinare se il controllo è basato sulla distinzione tra maiuscole e minuscole. Per impostazione predefinita, è impostata su true. |
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
La funzione doesNotContain viene utilizzata per determinare se una stringa non contiene una sottostringa specificata.
Formato
{STRING_1}.doesNotContain({STRING_2}, {BOOLEAN})
| Argomento | Descrizione |
|---|---|
{STRING_1} |
Stringa su cui eseguire il controllo. |
{STRING_2} |
Stringa da cercare all'interno della prima stringa. |
{BOOLEAN} |
Un parametro facoltativo per determinare se il controllo è basato sulla distinzione tra maiuscole e minuscole. Per impostazione predefinita, è impostata su true. |
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
La funzione equals viene utilizzata per determinare se una stringa è uguale alla stringa specificata.
Formato
{STRING_1}.equals({STRING_2})
| Argomento | Descrizione |
|---|---|
{STRING_1} |
Stringa su cui eseguire il controllo. |
{STRING_2} |
Stringa da confrontare con la prima stringa. |
Esempio
La seguente query PQL determina, con distinzione tra maiuscole e minuscole, se il nome della persona è "John".
person.name.equals("John")
Non uguale a
La funzione notEqualTo viene utilizzata per determinare se una stringa non è uguale alla stringa specificata.
Formato
{STRING_1}.notEqualTo({STRING_2})
| Argomento | Descrizione |
|---|---|
{STRING_1} |
Stringa su cui eseguire il controllo. |
{STRING_2} |
Stringa da confrontare con la prima stringa. |
Esempio
La seguente query PQL determina, con distinzione tra maiuscole e minuscole, se il nome della persona non è "John".
person.name.notEqualTo("John")
Corrisponde
La funzione matches viene utilizzata per determinare se una stringa corrisponde a una specifica espressione regolare. Per ulteriori informazioni sui pattern di corrispondenza nelle espressioni regolari, fare riferimento a questo documento.
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")
Gruppo di espressioni regolari
La funzione regexGroup 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)
Passaggi successivi
Ora che hai imparato le funzioni stringa, puoi usarle nelle tue query PQL. Per ulteriori informazioni sulle altre funzioni PQL, leggere la Panoramica del linguaggio di query profilo.