Zeichenfolgen-Funktionen string-functions

concat(<string>,<string>)

concat(<listString>)

Gibt eine Zeichenfolge zurück.

concat("Hello","World")

Gibt „HelloWorld“ zurück.

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

Gibt „Hello World“ zurück.

• string

contain(<string>,<string>)

Gibt einen booleschen Wert zurück.

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

Gibt „true“ zurück.

containIgnoreCase(<string>,<string>)

Gibt einen booleschen Wert zurück.

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

Gibt „true“ zurück.

endWith(<string>,<string>)

Gibt einen booleschen Wert zurück.

endWith("Hello World", "World")

Gibt „true“ zurück.

endWith("Hello World", "Hello")

Gibt „false“ zurück.

endWithIgnoreCase(<string>,<string>)

Gibt einen booleschen Wert zurück.

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

Gibt „true“ zurück.

• string

equalIgnoreCase(<string>,<string>)

Gibt einen booleschen Wert zurück.

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

Gibt „true“ zurück.

indexOf(<string>,<string>)

Gibt eine Ganzzahl zurück.

indexOf("Hello", "l")

Gibt 2 zurück.

Erklärung:

In „Hello“ befindet sich das erste Auftreten von „l“ an Position 2.

• string

isEmpty(<string>)

Gibt einen booleschen Wert zurück.

isEmpty("")

Gibt „true“ zurück.

isEmpty("Hello World")

Gibt „false“ zurück.

isEmpty(<null>)

Gibt „false“ zurück.

• string

isNotEmpty(<string>)

Gibt einen booleschen Wert zurück.

isNotEmpty("")

Gibt „false“ zurück.

isNotEmpty("hello")

Gibt „true“ zurück.

lastIndexOf(<string>,<string>)

Gibt eine Ganzzahl zurück.

lastIndexOf("Hello", "l")

Gibt 3 zurück.

Erklärung:

In „Hello“ befindet sich das letzte Auftreten von „l“ an Position 3.

• string

length(<string>)

Gibt eine Ganzzahl zurück.

length("Hello World")

Gibt 11 zurück.

• string

lower(<string>)

Gibt eine Zeichenfolge zurück.

lower("A")

Gibt „a“ zurück.

matchRegExp(<string>,<string>)

Gibt einen booleschen Wert zurück.

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

Gibt „true“ zurück.

• string

notEqualIgnoreCase(<string>,<string>)

Gibt einen booleschen Wert zurück.

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

Gibt eine Zeichenfolge zurück.

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

Gibt „Hexlo World“ zurück.

Beispiel mit RegExp:

Da der Zielparameter ein regulärer Ausdruck ist, müssen Sie je nach der Zeichenfolge, die Sie ersetzen möchten, möglicherweise einige Zeichen auslassen. Siehe folgendes Beispiel:

• auszuwertende Zeichenfolge: |OFFER_A|OFFER_B
• bereitgestellt von einem Profilattribut #{ExperiencePlatform.myFieldGroup.profile.myOffers}
• Zeichenfolge, die ersetzt werden soll: |OFFER_A
• Zeichenfolge ersetzt durch: ''
• Sie müssen \\ vor dem Zeichen | hinzufügen.

Der Ausdruck lautet:

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

Die zurückgegebene Zeichenfolge lautet: |OFFER_B

Sie können auch die Zeichenfolge erstellen, die mit einem bestimmten Attribut ersetzt werden soll:

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

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

Gibt eine Zeichenfolge zurück.

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

Gibt „Hexxo Worxd“ zurück.

Da der Zielparameter ein regulärer Ausdruck ist, müssen Sie je nach der Zeichenfolge, die Sie ersetzen möchten, möglicherweise einige Zeichen auslassen. Siehe das Beispiel in der Funktion replace.

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

Gibt eine listString zurück.

split("A_B_C", "_")

Gibt ["A","B","C"] zurück

Beispiel mit dem Ereignisfeld „event.appVersion“ mit dem Wert: 20.45.2.3434

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

Gibt ["20", "45", "2", "3434"] zurück

startWith(<string>,<string>)

Geben einen booleschen Wert zurück.

startWith("Hello World", "Hello")

Gibt „true“ zurück.

startWith("Hello World", "World")

Gibt „false“ zurück.

startWithIgnoreCase(<string>,<string>)

Geben einen booleschen Wert zurück.

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

Gibt „true“ zurück.

substr(<string>,<beginIndex>)

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

Gibt eine Zeichenfolge zurück.

substr("Hello World",6)

Gibt „World“ zurück.

substr("Hello World", 0, 5)

Gibt „Hello“ zurück.

trim(<string>)

Gibt eine Zeichenfolge zurück.

trim(" Hello ")

Gibt „Hello“ zurück.

upper(<string>)

Gibt eine Zeichenfolge zurück.

upper("b")

Gibt „B“ zurück.

uuid()

Gibt eine Zeichenfolge zurück.

uuid()

Gibt „79e70b7f-8a85-400b-97a1-9f9826121553“ zurück.

Dieser Abschnitt enthält strukturiertes Wissen zur Unterstützung von Interpretation, Abrufen und Antworten auf Fragen zu diesem Thema.

Zum vollständigen Verständnis sollten diese Informationen mit der Dokumentation auf dieser Seite kombiniert werden. Keine der beiden Quellen ist für Einzelpersonen gedacht. Die Seite beschreibt die Funktion, während dieser Abschnitt zusätzlichen Kontext bietet, der dabei hilft, Begriffe, Absichten, Anwendbarkeit und Begrenzungen zu unterscheiden.

• TL;DR: Auf dieser Seite werden alle Zeichenfolgenfunktionen dokumentiert, die in AJO-Journey-Ausdrücken verfügbar sind und die Textsuche, den Vergleich, die Transformation, die Extraktion, die Validierung, das Ersetzen, die Aufspaltung und die Erstellung eindeutiger Bezeichner abdecken.

intents:

• Verketten von zwei oder mehr Zeichenfolgen mithilfe von concat
• Suchen Sie mithilfe von contain oder containIgnoreCase nach einer Teilzeichenfolge in einer Zeichenfolge (Groß-/Kleinschreibung wird nicht beachtet)
• Vergleichen Sie zwei Zeichenfolgen, ohne die Groß-/Kleinschreibung zu berücksichtigen, indem Sie equalIgnoreCase oder notEqualIgnoreCase verwenden
• Überprüfen Sie, ob eine Zeichenfolge mit einem bestimmten Präfix oder Suffix beginnt oder endet, indem Sie startWith, endWith und die Varianten ohne Unterscheidung der Groß-/Kleinschreibung verwenden
• Extrahieren einer Teilzeichenfolge nach Indexpositionen mithilfe von substr
• Ersetzt das erste oder alle Vorkommen eines Musters in einer Zeichenfolge mit replace oder replaceAll
• Aufspalten einer Zeichenfolge in eine Liste von Token durch ein Trennzeichen mithilfe von split
• Generieren einer zufälligen UUID für eindeutige Kennungsanforderungen mithilfe von uuid
• Mit isEmpty oder isNotEmpty überprüfen, ob eine Zeichenfolge leer oder nicht leer ist

Glossar:

• RegExp: Ein Muster regulärer Ausdrücke, das als Zielparameter in replace, replaceAll und matchRegExp verwendet wird - Sonderzeichen müssen mit \\ maskiert werden
• UUID: Universeller eindeutiger Bezeichner - eine zufällig generierte Zeichenfolgenkennung, die von uuid() zurückgegeben wird
• substr: Extrahiert einen Teil einer Zeichenfolge durch Angabe eines Startindex und eines optionalen Endindex (nullbasiert)

Leitplanken:

• Der target Parameter in replace und replaceAll wird als RegExp behandelt. Sonderzeichen (z. B. |, .) müssen mit \\ maskiert werden
• replace ersetzt nur das erste übereinstimmende Vorkommen. Ersetzen Sie jedes Vorkommen mit replaceAll
• isEmpty gibt für Nullwerte „false“ zurück (nicht „true„); null wird nicht als leere Zeichenfolge betrachtet
• indexOf und lastIndexOf geben -1 zurück, wenn keine Übereinstimmung gefunden wird
• Zeichenfolgen-Indexpositionen sind nullbasiert (das erste Zeichen befindet sich an Position 0)

Terminologie:

• Kanonischer Name: Zeichenfolgen-Funktionen — Akronym: none — Varianten: Textfunktionen, Zeichenfolgen-Manipulationsfunktionen
• Synonyme: „contain“ = „Teilzeichenfolge überprüfen“; „split“ = „Tokenize string“; „trim“ = „strip whitespace“
• Verwechseln Sie nicht: „replace“ (nur erstes Vorkommen) ≠ „replaceAll“ (alle Vorkommen)
• Verwechseln Sie nicht: „indexOf“ (Position des ersten Vorkommens) ≠ „lastIndexOf“ (Position des letzten Vorkommens)
• Verwechseln Sie nicht: „isEmpty“ (wahr nur für Zeichenfolge mit Nulllänge) ≠ null check (isEmpty gibt „false“ für null zurück)
• Verwechseln Sie nicht: „equalIgnoreCase“ (gibt „true“ zurück, wenn „case ignoriert„) ≠ „notEqualIgnoreCase“ (gibt „true“ zurück, wenn ein anderer Groß-/Kleinschreibung ignoriert wird)

FAQ:

• F: Wie kann ich überprüfen, ob eine Zeichenfolge eine Teilzeichenfolge enthält, unabhängig von der Groß-/Kleinschreibung? — Verwenden Sie containIgnoreCase("myString", "searchTerm"), das „true“ zurückgibt, wenn der Suchbegriff in einem beliebigen Fall gefunden wird.
• F: Was ist der Unterschied zwischen replace und replaceAll? — replace ersetzt nur das erste übereinstimmende Vorkommen; replaceAll ersetzt jedes Vorkommen in der Zeichenfolge.
• F: Warum muss ich das | Zeichen in replace auslassen? — Der Zielparameter wird als regulärer Ausdruck behandelt. | ist ein spezielles RegExp-Zeichen und muss als \\| maskiert werden, damit er als Pipe behandelt wird.
• Q: Gibt isEmpty „true“ für null zurück? — Nein, isEmpty gibt „false“ für null zurück; es gibt nur „true“ für eine "" mit null Länge zurück.
• F: Wie extrahiere ich die Hauptversionsnummer aus einer Versionszeichenfolge wie „20.45.2.3434“? - Verwenden Sie getListItem(split(@event{event.appVersion}, "\\."), 0), um nach Punkt zu teilen und das erste Element abzurufen.
• F: Wie generiere ich eine eindeutige Kennung in einem Journey-Ausdruck? — Verwenden Sie uuid(), das eine zufällig generierte UUID-Zeichenfolge ohne erforderliche Parameter zurückgibt.