Funzioni stringa string

Scopri come utilizzare le funzioni String nell’editor di espressioni.

Camel Case camelCase

Il camelCase La funzione maiuscola la prima lettera 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

Il charCodeAt La funzione 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)%}

Concat concate

Il concat funzione 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

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

Sintassi

{%= contains(STRING_1, STRING_2, CASE_SENSITIVE) %}
Argomento
Descrizione
STRING_1
Stringa su cui eseguire il controllo.
STRING_2
Stringa da cercare nella prima stringa.
CASE_SENSITIVE
Un parametro opzionale per determinare se il controllo distingue tra maiuscole e minuscole. Valori possibili: true (predefinito) / false.

Esempi

  • 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

Il doesNotContain La funzione 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 su cui eseguire il controllo.
STRING_2
Stringa da cercare nella prima stringa.
CASE_SENSITIVE
Un parametro opzionale per determinare se il controllo distingue tra maiuscole e minuscole. Valori possibili: true (predefinito) / false.

Esempio

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

Il doesNotEndWith La funzione 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 su cui eseguire il controllo.
{STRING_2}
Stringa da cercare nella prima stringa.
{CASE_SENSITIVE}
Un parametro opzionale per determinare se il controllo distingue tra maiuscole e minuscole. Valori possibili: true (predefinito) / false.

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

Il doesNotStartWith La funzione 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 su cui eseguire il controllo.
{STRING_2}
Stringa da cercare nella prima stringa.
{CASE_SENSITIVE}
Un parametro opzionale per determinare se il controllo distingue tra maiuscole e minuscole. Valori possibili: true (predefinito) / false.

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

Il encode64 La funzione 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

Il 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 su cui eseguire il controllo.
{STRING_2}
Stringa da cercare nella prima stringa.
{CASE_SENSITIVE}
Un parametro opzionale per determinare se il controllo distingue tra maiuscole e minuscole. Valori possibili: true (predefinito) / false.

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

Il 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 su cui eseguire il controllo.
{STRING_2}
Stringa da confrontare con la prima stringa.

Esempio

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

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

Ignora maiuscole/minuscole uguale a equalsIgnoreCase

Il 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 su cui eseguire il controllo.
{STRING_2}
Stringa da confrontare con la prima stringa.

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

Il 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

Il formatCurrency La funzione 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

Il 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

Il getUrlPath La funzione 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

Il 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

Il 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
Argomento
Descrizione
{STRING_1}
Stringa su cui eseguire il controllo.
{STRING_2}
Stringa da cercare nel primo parametro

Esempio

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

Restituisce 6.

È vuoto isEmpty

Il 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

Il 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

Il lastIndexOf La funzione 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
Argomento
Descrizione
{STRING_1}
Stringa su cui eseguire il controllo.
{STRING_2}
Stringa da cercare nel primo parametro

Esempio

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

Restituisce 7.

Taglia a sinistra leftTrim

Il leftTrim La funzione viene utilizzata per rimuovere gli spazi bianchi dall’inizio di una stringa.

Sintassi

{%= leftTrim(string) %}

Lunghezza length

Il length La funzione 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

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

Sintassi

{%= like(STRING_1, 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 query seguente recupera tutte le città in cui vivono i profili che contengono il pattern "es".

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

Minuscolo lower

Il lowerCase funzione 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 matches

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.

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

Il Mask La funzione 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

Il md5 La funzione 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

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

Sintassi

{%= notEqualTo(STRING_1, STRING_2) %}
Argomento
Descrizione
{STRING_1}
Stringa su cui eseguire il controllo.
{STRING_2}
Stringa da confrontare con la prima stringa.

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 maiuscole/minuscole not-equal-with-ignore-case

Il notEqualWithIgnoreCase viene utilizzata per confrontare due stringhe ignorando la distinzione tra maiuscole e minuscole.

Sintassi

{= notEqualWithIgnoreCase(STRING_1,STRING_2) %}: boolean
Argomento
Descrizione
{STRING_1}
Stringa su cui eseguire il controllo.
{STRING_2}
Stringa da confrontare con la prima stringa.

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

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

Sintassi

{%= regexGroup(STRING, EXPRESSION, GROUP) %}
Argomento
Descrizione
{STRING}
Stringa su cui eseguire il controllo.
{EXPRESSION}
Espressione regolare da confrontare con la prima stringa.
{GROUP}
Gruppo di espressioni con cui confrontare.

Esempio

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

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

Sostituisci replace

Il replace La funzione viene utilizzata per sostituire una determinata sottostringa 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}
Sottostringa da sostituire.
{STRING_3}
La sottostringa di sostituzione.

Esempio

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

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

Sostituisci tutto replaceAll

Il replaceAll La funzione 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 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) %}
NOTE
Se l'espressione utilizzata come secondo argomento è un carattere regex speciale, utilizzare una doppia barra rovesciata (//). I caratteri regex speciali sono: [., +, *, ?, ^, $, (, ), [,], {, }, |, .]
Ulteriori informazioni in Documentazione di Oracle.

Taglia a destra rightTrim

Il rightTrim La funzione viene utilizzata per rimuovere gli spazi bianchi dalla fine di una stringa.

Sintassi

{%= rightTrim(string) %}

Divisione split

Il split La funzione viene utilizzata per dividere una stringa per un determinato carattere.

Sintassi

{%= split(string,string) %}

Inizia con startsWith

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

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

Il stringToDate funzione 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

Il 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

Il 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

Il Count string La funzione 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

Il titleCase La funzione 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) %}

To Bool to-bool

Il toBool funzione 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

Il toDateTime funzione viene utilizzata per convertire una stringa in data. In caso di input non valido, restituisce la data epoca come output.

Sintassi

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

Solo a data/ora to-date-time-only

Il toDateTimeOnly funzione 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

Trim (Taglia) trim

Il trim rimuove tutti gli spazi bianchi dall'inizio e dalla fine di una stringa.

Sintassi

{%= trim(string) %}

Maiuscolo upper

Il upperCase funzione 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

Il urlDecode viene utilizzata per decodificare una stringa con codifica url.

Sintassi

{%= urlDecode(string) %}: string

Codifica URL url-encode

Il Count only null La funzione viene utilizzata per codificare un URL in una stringa.

Sintassi

{%= urlEncode(string) %}: string
recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76