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}
Argomento
Descrizione
{STRING_1}
Stringa su cui eseguire il controllo.
{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})
Argomento
Descrizione
{STRING_1}
Stringa su cui eseguire il controllo.
{STRING_2}
Stringa da cercare nella prima stringa.
{BOOLEAN}
Un parametro opzionale per determinare se il controllo distingue tra maiuscole e minuscole. Per impostazione predefinita, questo è impostato 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

Il doesNotStartWith La funzione 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 nella prima stringa.
{BOOLEAN}
Un parametro opzionale per determinare se il controllo distingue tra maiuscole e minuscole. Per impostazione predefinita, questo è impostato 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

Il 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 nella prima stringa.
{BOOLEAN}
Un parametro opzionale per determinare se il controllo distingue tra maiuscole e minuscole. Per impostazione predefinita, questo è impostato 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

Il doesNotEndWith La funzione 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 nella prima stringa.
{BOOLEAN}
Un parametro opzionale per determinare se il controllo distingue tra maiuscole e minuscole. Per impostazione predefinita, questo è impostato 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

Il contains La funzione 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 nella prima stringa.
{BOOLEAN}
Un parametro opzionale per determinare se il controllo distingue tra maiuscole e minuscole. Per impostazione predefinita, questo è impostato 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

Il doesNotContain La funzione 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 nella prima stringa.
{BOOLEAN}
Un parametro opzionale per determinare se il controllo distingue tra maiuscole e minuscole. Per impostazione predefinita, questo è impostato 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

Il 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")

Diverso da

Il 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

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")
NOTE
Se utilizzi funzioni di espressione regolare come \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)
NOTE
Se utilizzi funzioni di espressione regolare come \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.

recommendation-more-help
770bc05d-534a-48a7-9f07-017ec1e14871