Funzioni stringa

Scopri come utilizzare le funzioni stringa nell’editor espressioni.

Cammello

La camelCase la funzione maiuscola la prima lettera di ogni parola di una stringa.

Sintassi

{%= camelCase(string)%}

Esempio

La funzione seguente capitalizza la prima lettera di parola nell'indirizzo della strada del profilo.

{%= camelCase(profile.homeAddress.street) %}

Codice caratt.

La charCodeAt restituisce il valore ASCII di un carattere, come la funzione charCodeAt in JavaScript. Prende una stringa e un numero intero (che definisce la posizione del carattere) come argomenti di input e restituisce il valore ASCII corrispondente.

Sintassi

{%= charCodeAt(string,int) %}: int

Esempio

La funzione seguente restituisce il valore ASCII di o.e. 111.

{%= charCodeAt("some", 1)%}

Concat

La concat la funzione combina due stringhe in una.

Sintassi

{%= concat(string,string) %}

Esempio

La funzione seguente combina la città del profilo e il paese in un’unica stringa.

{%= concat(profile.homeAddress.city,profile.homeAddress.country) %}

Contains

La contains viene utilizzata per determinare se una stringa contiene una sottostringa specificata.

Sintassi

{%= contains(STRING_1, STRING_2, CASE_SENSITIVE) %}

Argomento	Descrizione
STRING_1	Stringa da cui eseguire il controllo.
STRING_2	Stringa da cercare all’interno della prima stringa.
CASE_SENSITIVE	Un parametro facoltativo per determinare se il controllo è sensibile a maiuscole e minuscole. Valori possibili: true (predefinito) / false.

Esempi

• La funzione seguente controlla se il nome del profilo contiene la lettera A (in lettere maiuscole o minuscole). In questo caso, restituisce "true", altrimenti restituisce "false".

  {%= contains(profile.person.name.firstName, "A", false) %}
  

• La seguente query determina, con distinzione tra maiuscole e minuscole, se l’indirizzo e-mail della persona contiene la stringa "2010@gm".

  {%= contains(profile.person.emailAddress,"2010@gm") %}
  

Non contiene

La doesNotContain viene utilizzata per determinare se una stringa non contiene una sottostringa specificata.

Sintassi

{%= doesNotContain(STRING_1, STRING_2, CASE_SENSITIVE)%}

Argomento	Descrizione
STRING_1	Stringa da cui eseguire il controllo.
STRING_2	Stringa da cercare all’interno della prima stringa.
CASE_SENSITIVE	Un parametro facoltativo per determinare se il controllo è sensibile a maiuscole e minuscole. Valori possibili: true (predefinito) / false.

Esempio

La seguente query determina, con distinzione tra maiuscole e minuscole, se l’indirizzo e-mail della persona non contiene la stringa "2010@gm".

{%= doesNotContain(profile.person.emailAddress,"2010@gm")%}

Non termina con

La doesNotEndWith viene utilizzata per determinare se una stringa non termina con una sottostringa specificata.

Sintassi

{%= doesNotEndWith(STRING_1, STRING_2, CASE_SENSITIVE)%}

Argomento	Descrizione
{STRING_1}	Stringa da cui eseguire il controllo.
{STRING_2}	Stringa da cercare all’interno della prima stringa.
{CASE_SENSITIVE}	Un parametro facoltativo per determinare se il controllo è sensibile a maiuscole e minuscole. Valori possibili: true (predefinito) / false.

Esempio

La seguente query determina, con distinzione tra maiuscole e minuscole, se l’indirizzo e-mail della persona non termina con ".com".

doesNotEndWith(person.emailAddress,".com")

Non inizia con

La doesNotStartWith viene utilizzata per determinare se una stringa non inizia con una sottostringa specificata.

Sintassi

{%= doesNotStartWith(STRING_1, STRING_2, CASE_SENSITIVE)%}

Argomento	Descrizione
{STRING_1}	Stringa da cui eseguire il controllo.
{STRING_2}	Stringa da cercare all’interno della prima stringa.
{CASE_SENSITIVE}	Un parametro facoltativo per determinare se il controllo è sensibile a maiuscole e minuscole. Valori possibili: true (predefinito) / false.

Esempio

La seguente query determina, con distinzione tra maiuscole e minuscole, se il nome della persona non inizia con "Joe".

{%= doesNotStartWith(person.name,"Joe")%}

Codifica 64

La encode64 viene utilizzata per codificare una stringa per conservare le informazioni personali (PI) se devono essere incluse, ad esempio, in un URL.

Sintassi

{%= encode64(string) %}

Termina con

La endsWith viene utilizzata per determinare se una stringa termina con una sottostringa specificata.

Sintassi

{%= endsWith(STRING_1, STRING_2, CASE_SENSITIVE) %}

Argomento	Descrizione
{STRING_1}	Stringa da cui eseguire il controllo.
{STRING_2}	Stringa da cercare all’interno della prima stringa.
{CASE_SENSITIVE}	Un parametro facoltativo per determinare se il controllo è sensibile a maiuscole e minuscole. Valori possibili: true (predefinito) / false.

Esempio

La seguente query determina, con distinzione tra maiuscole e minuscole, se l’indirizzo e-mail della persona termina con ".com".

{%= endsWith(person.emailAddress,".com") %}

È uguale a

La equals viene utilizzata per determinare se una stringa è uguale alla stringa specificata, con distinzione tra maiuscole e minuscole.

Sintassi

{%= equals(STRING_1, STRING_2) %}

Argomento	Descrizione
{STRING_1}	Stringa da cui eseguire il controllo.
{STRING_2}	Stringa da confrontare con la prima stringa.

Esempio

La seguente query determina, con distinzione tra maiuscole e minuscole, se il nome della persona è "John".

{%=equals(profile.person.name,"John") %}

Uguale a Ignore Case

La equalsIgnoreCase viene utilizzata per determinare se una stringa è uguale alla stringa specificata, senza distinzione tra maiuscole e minuscole.

Sintassi

{%= equalsIgnoreCase(STRING_1, STRING_2) %}

Argomento	Descrizione
{STRING_1}	Stringa da cui eseguire il controllo.
{STRING_2}	Stringa da confrontare con la prima stringa.

Esempio

La seguente query determina, senza distinzione tra maiuscole e minuscole, se il nome della persona è "John".

{%= equalsIgnoreCase(profile.person.name,"John") %}

Estrai dominio e-mail

La extractEmailDomain viene utilizzata per estrarre il dominio di un indirizzo e-mail.

Sintassi

{%= extractEmailDomain(string) %}

Esempio

La seguente query estrae il dominio e-mail dell’indirizzo e-mail personale.

{%= extractEmailDomain(profile.personalEmail.address) %}

Formato valuta

La formatCurrency viene utilizzata per convertire qualsiasi numero nella corrispondente rappresentazione della valuta sensibile alla lingua a seconda delle impostazioni internazionali passate come stringa nel secondo argomento.

Sintassi

{%= formatCurrency(number/double,string) %}: string

Esempio

Questa query restituisce £ 56,00

{%= formatCurrency(56L,"en_GB") %}

Ottieni host url

La getUrlHost viene utilizzata per recuperare il nome host di un URL.

Sintassi

{%= getUrlHost(string) %}: string

Esempio

{%= getUrlHost("http://www.myurl.com/contact") %}

Restituisce "www.myurl.com"

Ottieni percorso URL

La getUrlPath viene utilizzata per recuperare il percorso dopo il nome di dominio di un URL.

Sintassi

{%= getUrlPath(string) %}: string

Esempio

{%= getUrlPath("http://www.myurl.com/contact.html") %}

Restituisce "/contact.html"

Ottieni protocollo url

La getUrlProtocol viene utilizzata per recuperare il protocollo di un URL.

Sintassi

{%= getUrlProtocol(string) %}: string

Esempio

{%= getUrlProtocol("http://www.myurl.com/contact.html") %}

Restituisce "http"

Indice

La indexOf viene utilizzata per restituire la posizione (nel primo argomento) della prima occorrenza del secondo parametro. Restituisce -1 se non è presente alcuna corrispondenza.

Sintassi

{%= indexOf(STRING_1, STRING_2) %}: integer

Argomento	Descrizione
{STRING_1}	Stringa da cui eseguire il controllo.
{STRING_2}	Stringa da cercare nel primo parametro

Esempio

{%= indexOf("hello world","world" ) %}

Restituisce 6.

È vuoto

La isEmpty viene utilizzata per determinare se una stringa è vuota.

Sintassi

{%= isEmpty(string) %}

Esempio

La funzione seguente restituisce "true" se il numero di telefono cellulare del profilo è vuoto. Altrimenti, restituirà "false".

{%= isEmpty(profile.mobilePhone.number) %}

Non è vuoto

La isNotEmpty viene utilizzata per determinare se una stringa non è vuota.

Sintassi

{= isNotEmpty(string) %}: boolean

Esempio

La funzione seguente restituisce "true" se il numero di telefono cellulare del profilo non è vuoto. Altrimenti, restituirà "false".

{%= isNotEmpty(profile.mobilePhone.number) %}

Ultimo Indice

La lastIndexOf viene utilizzata per restituire la posizione (nel primo argomento) dell'ultima occorrenza del secondo parametro. Restituisce -1 se non è presente alcuna corrispondenza.

Sintassi

{= lastIndexOf(STRING_1, STRING_2) %}: integer

Argomento	Descrizione
{STRING_1}	Stringa da cui eseguire il controllo.
{STRING_2}	Stringa da cercare nel primo parametro

Esempio

{%= lastIndexOf("hello world","o" ) %}

Restituisce 7.

Taglio a sinistra

La leftTrim viene utilizzata per rimuovere gli spazi vuoti dall'inizio di una stringa.

Sintassi

{%= leftTrim(string) %}

Lunghezza

La length viene utilizzato per ottenere il numero di caratteri in una stringa o un'espressione.

Sintassi

{%= length(string) %}

Esempio

La funzione seguente restituisce la lunghezza del nome della città del profilo.

{%= length(profile.homeAddress.city) %}

Simile

La like viene utilizzata per determinare se una stringa corrisponde a un pattern specificato.

Sintassi

{%= like(STRING_1, STRING_2) %}

Argomento	Descrizione
{STRING_1}	Stringa da cui eseguire il controllo.
{STRING_2}	Espressione da confrontare con la prima stringa. Sono disponibili due caratteri speciali supportati per la creazione di un’espressione: % e _. % viene utilizzato per rappresentare zero o più caratteri. _ viene utilizzato per rappresentare esattamente un carattere.

Esempio

La seguente query recupera tutte le città in cui i profili vivono contenenti il pattern "es".

{%= like(profile.homeAddress.city, "%es%")%}

Custodia minuscola

La lowerCase converte una stringa in lettere minuscole.

Sintassi

{%= lowerCase(string) %}

Esempio

Questa funzione converte il nome del profilo in lettere minuscole.

{%= lowerCase(profile.person.name.firstName) %}

Corrisponde

La matches viene utilizzata per determinare se una stringa corrisponde a una specifica espressione regolare. Fai riferimento a presente documento per ulteriori informazioni sui pattern di corrispondenza nelle espressioni regolari.

Sintassi

{%= matches(STRING_1, STRING_2) %}

Esempio

La seguente query determina, senza distinzione tra maiuscole e minuscole, se il nome della persona inizia con "John".

{%= matches(person.name.,"(?i)^John") %}

Maschera

La Mask viene utilizzata per sostituire una parte di una stringa con caratteri "X".

Sintassi

{%= mask(string,integer,integer) %}

Esempio

La seguente query sostituisce la stringa "123456789" con caratteri "X", ad eccezione dei primi e degli ultimi 2 caratteri.

{%= mask("123456789",1,2) %}

La query restituisce 1XXXXXX89.

MD5

La md5 viene utilizzata per calcolare e restituire l'hash md5 di una stringa.

Sintassi

{%= md5(string) %}: string

Esempio

{%= md5("hello world") %}

Restituisce "5eb63bbbe01eeed093cb22bb8f5acdc3"

Non uguale a

La notEqualTo viene utilizzata per determinare se una stringa non è uguale alla stringa specificata.

Sintassi

{%= notEqualTo(STRING_1, STRING_2) %}

Argomento	Descrizione
{STRING_1}	Stringa da cui eseguire il controllo.
{STRING_2}	Stringa da confrontare con la prima stringa.

Esempio

La seguente query determina, con distinzione tra maiuscole e minuscole, se il nome della persona non è "John".

{%= notEqualTo(profile.person.name,"John") %}

Non uguale a Ignora maiuscole/minuscole

La notEqualWithIgnoreCase viene utilizzata per confrontare due stringhe che ignorano maiuscole/minuscole.

Sintassi

{= notEqualWithIgnoreCase(STRING_1,STRING_2) %}: boolean

Argomento	Descrizione
{STRING_1}	Stringa da cui eseguire il controllo.
{STRING_2}	Stringa da confrontare con la prima stringa.

Esempio

La seguente query determina se il nome della persona non è "john", senza distinzione tra maiuscole e minuscole.

{%= notEqualTo(profile.person.name,"john") %}

Gruppo di espressioni regolari

La Group viene utilizzata per estrarre informazioni specifiche, in base all'espressione regolare fornita.

Sintassi

{%= regexGroup(STRING, EXPRESSION, GROUP) %}

Argomento	Descrizione
{STRING}	Stringa da cui eseguire il controllo.
{EXPRESSION}	L'espressione regolare da abbinare alla prima stringa.
{GROUP}	Gruppo di espressioni con cui confrontarsi.

Esempio

La seguente query viene utilizzata per estrarre il nome di dominio da un indirizzo e-mail.

{%= regexGroup(emailAddress,"@(\\w+)", 1) %}

Sostituisci

La replace viene utilizzata per sostituire una stringa secondaria specificata in una stringa con un'altra sottostringa.

Sintassi

{%= replace(STRING_1,STRING_2,STRING_3) %}:string

Argomento	Descrizione
{STRING_1}	Stringa in cui deve essere sostituita la sottostringa.
{STRING_2}	La sottostringa da sostituire.
{STRING_3}	La sottostringa sostitutiva.

Esempio

{%= replace("Hello John, here is your monthly newsletter!","John","Mark") %}

Restituisce "Ciao Mark, ecco la tua newsletter mensile!"

Sostituisci tutto

La replaceAll viene utilizzata per sostituire tutte le sottostringhe di un testo che corrispondono all'espressione "regex" con la stringa letterale di "sostituzione" specificata. Regex ha una speciale gestione di "" e "+" e tutte le espressioni regex seguono la strategia di escape PQL. La sostituzione procede dall’inizio della stringa alla fine, ad esempio sostituendo "aa" con "b" nella stringa "aaa" si otterrà "ba" invece di "ab".

Sintassi

{%= replaceAll(string,string,string) %}

Taglio a destra

La rightTrim viene utilizzata per rimuovere gli spazi bianchi dall'estremità di una stringa.

Sintassi

{%= rightTrim(string) %}

Dividere

La split viene utilizzata per dividere una stringa in base a un carattere specificato.

Sintassi

{%= split(string,string) %}

Inizia con

La startsWith viene utilizzata per determinare se una stringa inizia con una sottostringa specificata.

Sintassi

{%= startsWith(STRING_1, STRING_2, CASE_SENSITIVE) %}

Argomento	Descrizione
{STRING_1}	Stringa da cui eseguire il controllo.
{STRING_2}	Stringa da cercare all’interno della prima stringa.
{CASE_SENSITIVE}	Un parametro facoltativo per determinare se il controllo è sensibile a maiuscole e minuscole. Per impostazione predefinita, è impostato su true.

Esempio

La seguente query determina, con distinzione tra maiuscole e minuscole, se il nome della persona inizia con "Joe".

{%= startsWith(person.name,"Joe") %}

Stringa alla data

La stringToDate converte un valore stringa in un valore data-ora. Sono necessari due argomenti: rappresentazione stringa di una data-ora e rappresentazione stringa del formattatore.

Sintassi

{= stringToDate("date-time value","formatter" %}

Esempio

{= stringToDate("2023-01-10 23:13:26", "yyyy-MM-dd HH:mm:ss") %}

Stringa a numero intero

La string_to_integer viene utilizzata per convertire un valore stringa in un valore intero.

Sintassi

{= string_to_integer(string) %}: int

Stringa al numero

La stringToNumber viene utilizzata per convertire una stringa in numero. Restituisce la stessa stringa dell'output per input non valido.

Sintassi

{%= stringToNumber(string) %}: double

Sottostringa

La Count string viene utilizzata per restituire la sottostringa dell'espressione stringa tra l'indice begin e l'indice end.
Sintassi

{= substr(string, integer, integer) %}: string

Caso del titolo

La titleCase viene utilizzata per utilizzare le lettere iniziali di ogni parola di una stringa.

Sintassi

{%= titleCase(string) %}

Esempio

Se la persona vive a Washington High Street, questa funzione restituirà Washington High Street.

{%= titleCase(profile.person.location.Street) %}

A Bool

La toBool viene utilizzato per convertire un valore di argomento in un valore booleano, a seconda del tipo.

Sintassi

{= toBool(string) %}: boolean

A ora

La toDateTime viene utilizzata per convertire la stringa in data. Restituisce la data epoch come output per input non valido.

Sintassi

{%= toDateTime(string, string) %}: date-time

Solo per ora

La toDateTimeOnly viene utilizzata per convertire un valore di argomento in un valore solo di data e ora. Restituisce la data epoch come output per input non valido. Questa funzione accetta tipi di campi stringa, data, long e int.

Sintassi

{%= toDateTimeOnly(string/date/long/int) %}: date-time

Trim (Taglia)

La trim rimuove tutti gli spazi bianchi dall'inizio e alla fine di una stringa.

Sintassi

{%= trim(string) %}

Caso superiore

La UpCase converte una stringa in lettere maiuscole.

Sintassi

{%= upperCase(string) %}

Esempio

Questa funzione converte il cognome del profilo in lettere maiuscole.

{%= upperCase(profile.person.name.lastName) %}

decodifica URL

La urlDecode viene utilizzata per decodificare una stringa codificata in url.

Sintassi

{%= urlDecode(string) %}: string

Codifica URL

La Count only null viene utilizzata per codificare in url una stringa.

Sintassi

{%= urlEncode(string) %}: string