Funzioni stringa string-functions

concat(<string>,<string>)

concat(<listString>)

Restituisce una stringa.

concat("Hello","World")

Restituisce “HelloWorld”.

concat(["Hello"," ","World"])

Restituisce “Hello World”.

• stringa

contain(<string>,<string>)

Restituisce un valore booleano.

contain("rowing is great", "great")

Restituisce true.

containIgnoreCase(<string>,<string>)

Restituisce un valore booleano.

containIgnoreCase("rowing is great", "GREAT")

Restituisce true.

endWith(<string>,<string>)

Restituisce un valore booleano.

endWith("Hello World", "World")

Restituisce true.

endWith("Hello World", "Hello")

Restituisce false.

endWithIgnoreCase(<string>,<string>)

Restituisce un valore booleano.

endWithIgnoreCase("rowing is great", "AT")

Restituisce true.

• stringa

equalIgnoreCase(<string>,<string>)

Restituisce un valore booleano.

equalIgnoreCase("rowing is great", "rowing is GREAT")

Restituisce true.

indexOf(<string>,<string>)

Restituisce un numero intero.

indexOf("Hello", "l")

Restituisce 2.

Spiegazione:

In “Hello”, la prima occorrenza di “l” è nella posizione 2.

• stringa

isEmpty(<string>)

Restituisce un valore booleano.

isEmpty("")

Restituisce true.

isEmpty("Hello World")

Restituisce false.

isEmpty(<null>)

Restituisce false.

• stringa

isNotEmpty(<string>)

Restituisce un valore booleano.

isNotEmpty("")

Restituisce false.

isNotEmpty("hello")

Restituisce true.

lastIndexOf(<string>,<string>)

Restituisce un numero intero.

lastIndexOf("Hello", "l")

Restituisce 3.

Spiegazione:

In “Hello”, l’ultima occorrenza di “l” è nella posizione 3.

• stringa

length(<string>)

Restituisce un numero intero.

length("Hello World")

Restituisce 11.

• stringa

lower(<string>)

Restituisce una stringa.

lower("A")

Restituisce “a”.

matchRegExp(<string>,<string>)

Restituisce un valore booleano.

matchRegExp("12345", "\\d+")

Restituisce true.

• stringa

notEqualIgnoreCase(<string>,<string>)

Restituisce un valore booleano.

replace(<base>,<target>,<replacement>)

Restituisce una stringa.

replace("Hello World", "l", "x")

Restituisce “Hexlo World”.

Esempio con RegExp:

Poiché il parametro di destinazione è un RegExp, a seconda della stringa che si desidera sostituire, potrebbe essere necessario eseguire l’escape di alcuni caratteri. Ecco un esempio:

• stringa da valutare: |OFFER_A|OFFER_B
• fornito da un attributo di profilo #{ExperiencePlatform.myFieldGroup.profile.myOffers}
• Stringa da sostituire: |OFFER_A
• Stringa sostituita da: ''
• Aggiungere \\ prima del carattere |.

L’espressione è:

replace(#{ExperiencePlatform.myFieldGroup.profile.myOffers}, '\\|OFFER_A', '')

La stringa restituita è: |OFFER_B

Puoi anche creare la stringa da sostituire da un dato attributo:

replace(#{ExperiencePlatform.myFieldGroup.profile.myOffers}, '\\|' + #{ExperiencePlatform.myFieldGroup.profile.myOfferCode}, '')

replaceAll(<baseString>,<sourceString>,<replacementString>)

Restituisce una stringa.

replaceAll("Hello World", "l", "x")

Restituisce “Hexxo Worxd”.

Poiché il parametro di destinazione è un RegExp, a seconda della stringa che si desidera sostituire, potrebbe essere necessario eseguire l’escape di alcuni caratteri. Consulta l’esempio nella funzione replace.

split(<input string>, <separator string>)

Restituisce un valore listString.

split("A_B_C", "_")

Restituisce ["A","B","C"]

Esempio con un campo evento “event.appVersion” con valore: “20.45.2.3434”

split(@event{event.appVersion}, "\\.")

Restituisce ["20", "45", "2", "3434"]

startWith(<string>,<string>)

Restituisce un valore booleano.

startWith("Hello World", "Hello")

Restituisce true.

startWith("Hello World", "World")

Restituisce false.

startWithIgnoreCase(<string>,<string>)

Restituisce un valore booleano.

startWithIgnoreCase("rowing is great", "RO")

Restituisce true.

substr(<string>,<beginIndex>)

substr(<string>,<beginIndex>,<endIndex>)

Restituisce una stringa.

substr("Hello World",6)

Restituisce “World”.

substr("Hello World", 0, 5)

Restituisce “Hello”.

trim(<string>)

Restituisce una stringa.

trim(" Hello ")

Restituisce “Hello”.

upper(<string>)

Restituisce una stringa.

upper("b")

Restituisce “B”.

uuid()

Restituisce una stringa.

uuid()

Restituisce “79e70b7f-8a85-400b-97a1-9f9826121553”.

Questa sezione contiene informazioni strutturate che supportano l’interpretazione, il recupero e la risposta alle domande relative a questo argomento.

Per una comprensione completa, queste informazioni devono essere unite alla documentazione su questa pagina. Nessuna delle due origini è progettata per essere indipendente; la pagina descrive la funzione, mentre questa sezione fornisce un contesto aggiuntivo che aiuta a non ambiguare la terminologia, le finalità, l’applicabilità e i vincoli.

• TL;DR: In questa pagina sono documentate tutte le funzioni di stringa disponibili nelle espressioni di percorso AJO, che includono la ricerca di testo, il confronto, la trasformazione, l’estrazione, la convalida, la sostituzione, la suddivisione e la generazione di identificatori univoci.

Intenti:

• Concatena due o più stringhe utilizzando concat
• Cercare una sottostringa all’interno di una stringa (distinzione maiuscole/minuscole o senza distinzione maiuscole/minuscole) utilizzando contain o containIgnoreCase
• Confronta due stringhe ignorando la distinzione tra maiuscole e minuscole utilizzando equalIgnoreCase o notEqualIgnoreCase
• Verifica se una stringa inizia o termina con un prefisso o un suffisso specifico utilizzando startWith, endWith e le relative varianti senza distinzione tra maiuscole e minuscole
• Estrarre una sottostringa in base alle posizioni di indice utilizzando substr
• Sostituire la prima o tutte le occorrenze di un pattern in una stringa utilizzando replace o replaceAll
• Dividere una stringa in un elenco di token con un separatore utilizzando split
• Genera un UUID casuale per le esigenze di identificatori univoci utilizzando uuid
• Verificare se una stringa è vuota o non vuota utilizzando isEmpty o isNotEmpty

Glossario:

• RegExp: un pattern di espressione regolare utilizzato come parametro di destinazione in replace, replaceAll e matchRegExp. I caratteri speciali devono essere preceduti da \\
• UUID: IDentifier univoco universale — un identificatore di stringa generato in modo casuale restituito da uuid()
• substr: estrae una parte di una stringa specificando un indice iniziale e un indice finale facoltativo (basato su zero)

Guardrail:

• Il parametro target in replace e replaceAll è trattato come RegExp; i caratteri speciali (ad esempio |, .) devono essere preceduti da \\
• replace sostituisce solo la prima occorrenza corrispondente; utilizzare replaceAll per sostituire ogni occorrenza
• isEmpty restituisce false per i valori null (non true); null non è considerato una stringa vuota
• indexOf e lastIndexOf restituiscono -1 quando non viene trovata alcuna corrispondenza
• Le posizioni dell’indice stringa sono basate su zero (il primo carattere si trova nella posizione 0)

Terminologia:

• Nome canonico: Funzioni stringa — Acronimo: none — Varianti: funzioni testo, funzioni di manipolazione stringa
• Sinonimi: “contain” = “substring check”; “split” = “tokenize string”; “trim” = “strip whitespace”
• Non confondere: “replace” (solo prima occorrenza) ≠ “replaceAll” (tutte le occorrenze)
• Non confondere: “indexOf” (prima posizione di occorrenza) ≠ “lastIndexOf” (ultima posizione di occorrenza)
• Non confondere: “isEmpty” (true solo per stringa di lunghezza zero) ≠ null check (isEmpty restituisce false per null)
• Non confondere: “equalIgnoreCase” (restituisce true se equal ignora case) ≠ “notEqualIgnoreCase” (restituisce true se diverse ignorano case)

Domande frequenti:

• D: come posso verificare se una stringa contiene una sottostringa indipendentemente dalle maiuscole/minuscole? — Utilizzare containIgnoreCase("myString", "searchTerm"), che restituisce true se il termine di ricerca viene trovato in ogni caso.
• Q: Qual è la differenza tra replace e replaceAll? — replace sostituisce solo la prima occorrenza corrispondente; replaceAll sostituisce ogni occorrenza nella stringa.
• Q: perché è necessario eseguire l’escape del carattere | in replace? — Il parametro di destinazione viene trattato come espressione regolare; | è un carattere RegExp speciale e deve essere escluso come \\| per essere trattato come una pipe letterale.
• Q: isEmpty restituisce true per null? — No, isEmpty restituisce false per null; restituisce true solo per una stringa di lunghezza zero "".
• D: come posso estrarre il numero di versione principale da una stringa di versione come “20.45.2.3434”? — Utilizzare getListItem(split(@event{event.appVersion}, "\\."), 0) per dividere per punto e recuperare il primo elemento.
• D: come si genera un identificatore univoco in un’espressione di percorso? — Utilizzare uuid(), che restituisce una stringa UUID generata in modo casuale senza parametri richiesti.