Funzioni stringa string
Scopri come utilizzare le funzioni stringa nell’editor di personalizzazione.
Camel Case camelCase
La funzione camelCase utilizza l'iniziale maiuscola di ogni parola di una stringa.
Sintassi
{%= camelCase(string)%}
Esempio
La funzione seguente metterà in maiuscolo la prima lettera di parola nell’indirizzo stradale del profilo.
{%= camelCase(profile.homeAddress.street) %}
Codice carattere in corrispondenza di char-code-at
La funzione charCodeAt restituisce il valore ASCII di un carattere, come la funzione charCodeAt in JavaScript. Come argomenti di input sono necessari una stringa e un numero intero (che definisce la posizione del carattere) e viene restituito il valore ASCII corrispondente.
Sintassi
{%= charCodeAt(string,int) %}: int
Esempio
La funzione seguente restituisce il valore ASCII o i.e 111.
{%= charCodeAt("some", 1)%}
Concatena concate
La funzione concat combina due stringhe in una.
Sintassi
{%= concat(string,string) %}
Esempio
La funzione seguente combina il profilo città e paese in una singola stringa.
{%= concat(profile.homeAddress.city,profile.homeAddress.country) %}
Contains contains
La funzione contains viene utilizzata per determinare se una stringa contiene una sottostringa specificata.
Sintassi
{%= contains(STRING_1, STRING_2, CASE_SENSITIVE) %}
STRING_1STRING_2CASE_SENSITIVEEsempi
-
La funzione seguente verifica se il nome del profilo contiene la lettera A (in maiuscolo o minuscolo). In questo caso, restituirà "true", altrimenti restituirà "false".
code language-sql {%= contains(profile.person.name.firstName, "A", false) %} -
La query seguente determina, con distinzione tra maiuscole e minuscole, se l’indirizzo e-mail della persona contiene la stringa "2010@gm".
code language-sql {%= contains(profile.person.emailAddress,"2010@gm") %}
Non contiene doesNotContain
La funzione doesNotContain viene utilizzata per determinare se una stringa non contiene una sottostringa specificata.
Sintassi
{%= doesNotContain(STRING_1, STRING_2, CASE_SENSITIVE)%}
STRING_1STRING_2CASE_SENSITIVEEsempio
La query seguente 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 doesNotEndWith
La funzione doesNotEndWith viene utilizzata per determinare se una stringa non termina con una sottostringa specificata.
Sintassi
{%= doesNotEndWith(STRING_1, STRING_2, CASE_SENSITIVE)%}
{STRING_1}{STRING_2}{CASE_SENSITIVE}Esempio
La query seguente 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 doesNotStartWith
La funzione doesNotStartWith viene utilizzata per determinare se una stringa non inizia con una sottostringa specificata.
Sintassi
{%= doesNotStartWith(STRING_1, STRING_2, CASE_SENSITIVE)%}
{STRING_1}{STRING_2}{CASE_SENSITIVE}Esempio
La query seguente determina, con distinzione tra maiuscole e minuscole, se il nome della persona non inizia con "Joe".
{%= doesNotStartWith(person.name,"Joe")%}
Codifica 64 encode64
La funzione encode64 viene utilizzata per codificare una stringa per conservare le informazioni personali (PI) se da includere, ad esempio, in un URL.
Sintassi
{%= encode64(string) %}
Termina con endsWith
La funzione endsWith viene utilizzata per determinare se una stringa termina con una sottostringa specificata.
Sintassi
{%= endsWith(STRING_1, STRING_2, CASE_SENSITIVE) %}
{STRING_1}{STRING_2}{CASE_SENSITIVE}Esempio
La query seguente determina, con distinzione tra maiuscole e minuscole, se l’indirizzo e-mail della persona termina con ".com".
{%= endsWith(person.emailAddress,".com") %}
Uguale a equals
La funzione equals viene utilizzata per determinare se una stringa è uguale alla stringa specificata, con distinzione tra maiuscole e minuscole.
Sintassi
{%= equals(STRING_1, STRING_2) %}
{STRING_1}{STRING_2}Esempio
La query seguente determina, con distinzione tra maiuscole e minuscole, se il nome della persona è "John".
{%=equals(profile.person.name,"John") %}
Uguale a ignora distinzione tra maiuscole e minuscole equalsIgnoreCase
La funzione equalsIgnoreCase viene utilizzata per determinare se una stringa è uguale alla stringa specificata, senza distinzione tra maiuscole e minuscole.
Sintassi
{%= equalsIgnoreCase(STRING_1, STRING_2) %}
{STRING_1}{STRING_2}Esempio
La query seguente determina se il nome della persona è "John" senza distinzione tra maiuscole e minuscole.
{%= equalsIgnoreCase(profile.person.name,"John") %}
Estrai dominio e-mail extractEmailDomain
La funzione extractEmailDomain viene utilizzata per estrarre il dominio di un indirizzo e-mail.
Sintassi
{%= extractEmailDomain(string) %}
Esempio
La query seguente estrae il dominio e-mail dell’indirizzo e-mail personale.
{%= extractEmailDomain(profile.personalEmail.address) %}
Formato valuta format-currency
La funzione formatCurrency viene utilizzata per convertire qualsiasi numero nella corrispondente rappresentazione della valuta sensibile alla lingua a seconda delle impostazioni locali 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 get-url-host
La funzione getUrlHost viene utilizzata per recuperare il nome host di un URL.
Sintassi
{%= getUrlHost(string) %}: string
Esempio
{%= getUrlHost("https://www.myurl.com/contact") %}
Restituisce "www.myurl.com"
Ottieni percorso URL get-url-path
La funzione getUrlPath viene utilizzata per recuperare il percorso dopo il nome di dominio di un URL.
Sintassi
{%= getUrlPath(string) %}: string
Esempio
{%= getUrlPath("https://www.myurl.com/contact.html") %}
Restituisce "/contact.html"
Ottieni protocollo URL get-url-protocol
La funzione getUrlProtocol viene utilizzata per recuperare il protocollo di un URL.
Sintassi
{%= getUrlProtocol(string) %}: string
Esempio
{%= getUrlProtocol("https://www.myurl.com/contact.html") %}
Restituisce "http"
Indice di index-of
La funzione indexOf viene utilizzata per restituire la posizione (nel primo argomento) della prima occorrenza del secondo parametro. Restituisce -1 se non viene trovata alcuna corrispondenza.
Sintassi
{%= indexOf(STRING_1, STRING_2) %}: integer
{STRING_1}{STRING_2}Esempio
{%= indexOf("hello world","world" ) %}
Restituisce 6.
È vuoto isEmpty
La funzione 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 is-not-empty
La funzione 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 di last-index-of
La funzione lastIndexOf viene utilizzata per restituire la posizione (nel primo argomento) dell'ultima occorrenza del secondo parametro. Restituisce -1 se non viene trovata alcuna corrispondenza.
Sintassi
{= lastIndexOf(STRING_1, STRING_2) %}: integer
{STRING_1}{STRING_2}Esempio
{%= lastIndexOf("hello world","o" ) %}
Restituisce 7.
Taglia a sinistra leftTrim
La funzione leftTrim viene utilizzata per rimuovere gli spazi dall'inizio di una stringa.
Sintassi
{%= leftTrim(string) %}
Lunghezza length
La funzione length viene utilizzata per ottenere il numero di caratteri in una stringa o in un'espressione.
Sintassi
{%= length(string) %}
Esempio
La funzione seguente restituisce la lunghezza del nome della città del profilo.
{%= length(profile.homeAddress.city) %}
Simile a like
La funzione like viene utilizzata per determinare se una stringa corrisponde a un pattern specificato.
Sintassi
{%= like(STRING_1, STRING_2) %}
{STRING_1}{STRING_2}Espressione da confrontare con la prima stringa. Per la creazione di un'espressione sono supportati due caratteri speciali: % e _.
%viene utilizzato per rappresentare zero o più caratteri._viene utilizzato per rappresentare esattamente un carattere.
Esempio
La query seguente recupera tutte le città in cui vivono i profili che contengono il pattern "es".
{%= like(profile.homeAddress.city, "%es%")%}
Minuscolo lower
La funzione 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 a matches
La funzione 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.
Sintassi
{%= matches(STRING_1, STRING_2) %}
Esempio
La query seguente determina, senza distinzione tra maiuscole e minuscole, se il nome della persona inizia con "John".
{%= matches(person.name.,"(?i)^John") %}
Maschera mask
La funzione Mask viene utilizzata per sostituire una parte di stringa con caratteri "X".
Sintassi
{%= mask(string,integer,integer) %}
Esempio
La query seguente sostituisce la stringa "123456789" con caratteri "X", ad eccezione del primo e dell’ultimo secondo carattere.
{%= mask("123456789",1,2) %}
La query restituisce 1XXXXXX89.
MD5 md5
La funzione 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 notEqualTo
La funzione notEqualTo viene utilizzata per determinare se una stringa non è uguale alla stringa specificata.
Sintassi
{%= notEqualTo(STRING_1, STRING_2) %}
{STRING_1}{STRING_2}Esempio
La query seguente determina, con distinzione tra maiuscole e minuscole, se il nome della persona non è "John".
{%= notEqualTo(profile.person.name,"John") %}
Non è uguale con ignora distinzione tra maiuscole e minuscole not-equal-with-ignore-case
La funzione notEqualWithIgnoreCase viene utilizzata per confrontare due stringhe ignorando la distinzione tra maiuscole e minuscole.
Sintassi
{= notEqualWithIgnoreCase(STRING_1,STRING_2) %}: boolean
{STRING_1}{STRING_2}Esempio
La query seguente determina se il nome della persona non è "John", senza distinzione tra maiuscole e minuscole.
{%= notEqualTo(profile.person.name,"john") %}
Gruppo di espressioni regolari regexGroup
La funzione Group viene utilizzata per estrarre informazioni specifiche, in base all'espressione regolare fornita.
Sintassi
{%= regexGroup(STRING, EXPRESSION, GROUP) %}
{STRING}{EXPRESSION}{GROUP}Esempio
La query seguente viene utilizzata per estrarre il nome di dominio da un indirizzo e-mail.
{%= regexGroup(emailAddress,"@(\\w+)", 1) %}
Sostituisci replace
La funzione replace viene utilizzata per sostituire una determinata sottostringa in una stringa con un'altra sottostringa.
Sintassi
{%= replace(STRING_1,STRING_2,STRING_3) %}:string
{STRING_1}{STRING_2}{STRING_3}Esempio
{%= replace("Hello John, here is your monthly newsletter!","John","Mark") %}
Restituisce "Ciao Mark, ecco la tua newsletter mensile!"
Sostituisci tutto replaceAll
La funzione replaceAll viene utilizzata per sostituire tutte le sottostringhe di un testo che corrisponde all'espressione "regex" con la stringa letterale "replace" specificata. Regex gestisce in modo particolare "" e "+" e tutte le espressioni regex seguono la strategia di escape di 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) %}
//). I caratteri regex speciali sono: [., +, *, ?, ^, $, (, ), [,], {, }, |, .]Taglia a destra rightTrim
La funzione rightTrim viene utilizzata per rimuovere gli spazi dalla fine di una stringa.
Sintassi
{%= rightTrim(string) %}
Divisione split
La funzione split viene utilizzata per dividere una stringa per un determinato carattere.
Sintassi
{%= split(string,string) %}
Inizia con startsWith
La funzione startsWith viene utilizzata per determinare se una stringa inizia con una sottostringa specificata.
Sintassi
{%= startsWith(STRING_1, STRING_2, CASE_SENSITIVE) %}
{STRING_1}{STRING_2}{CASE_SENSITIVE}Esempio
La query seguente determina, con distinzione tra maiuscole e minuscole, se il nome della persona inizia con "Joe".
{%= startsWith(person.name,"Joe") %}
Stringa a data string-to-date
La funzione stringToDate converte un valore stringa in un valore data-ora. Sono necessari due argomenti: la rappresentazione in forma di stringa di una data/ora e la rappresentazione in forma di 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 string-to-integer
La funzione string_to_integer viene utilizzata per convertire un valore stringa in un valore intero.
Sintassi
{= string_to_integer(string) %}: int
Stringa a numero string-to-number
La funzione stringToNumber viene utilizzata per convertire una stringa in numero. In caso di input non valido, restituisce la stessa stringa come output.
Sintassi
{%= stringToNumber(string) %}: double
Sottostringa sub-string
La funzione Count string viene utilizzata per restituire la sottostringa dell'espressione stringa tra l'indice iniziale e l'indice finale.
Sintassi
{= substr(string, integer, integer) %}: string
Tutte iniziali maiuscole titleCase
La funzione titleCase viene utilizzata per rendere maiuscole le prime lettere di ciascuna 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 valore booleano to-bool
La funzione toBool viene utilizzata per convertire un valore di argomento in un valore booleano, a seconda del tipo.
Sintassi
{= toBool(string) %}: boolean
A data/ora to-date-time
La funzione toDateTime viene utilizzata per convertire la stringa in data. In caso di input non valido, restituisce la data epoca come output.
Sintassi
{%= toDateTime(string, string) %}: date-time
Solo a ora/data to-date-time-only
La funzione toDateTimeOnly viene utilizzata per convertire un valore di argomento in un valore di sola data e ora. In caso di input non valido, restituisce la data epoca come output. Questa funzione accetta tipi di campo stringa, data, long e int.
Sintassi
{%= toDateTimeOnly(string/date/long/int) %}: date-time
Taglia trim
La funzione trim rimuove tutti gli spazi dall'inizio e dalla fine di una stringa.
Sintassi
{%= trim(string) %}
Maiuscolo upper
La funzione upperCase 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 url-decode
La funzione urlDecode viene utilizzata per decodificare una stringa con codifica URL.
Sintassi
{%= urlDecode(string) %}: string
Codifica URL url-encode
La funzione Count only null viene utilizzata per la codifica URL di una stringa.
Sintassi
{%= urlEncode(string) %}: string