Zeichenfolgen-Funktionen
- Themen:
- Personalisierung
Erstellt für:
- Experte
- Entwickler
Erfahren Sie, wie Sie im Personalisierungseditor Zeichenfolgenfunktionen verwenden können.
Binnenmajuskel
Mit der Funktion camelCase wird der erste Buchstabe eines jeden Wortes einer Zeichenfolge großgeschrieben.
Syntax
{%= camelCase(string)%}
Beispiel
Mit der folgenden Funktion wird der erste Buchstabe der Straßenadresse des Profils großgeschrieben.
{%= camelCase(profile.homeAddress.street) %}
Char-Code bei
Die Funktion charCodeAt gibt den ASCII-Wert eines Zeichens zurück, z. B. die Funktion charCodeAt in JavaScript. Als Eingabeargumente werden eine Zeichenfolge und eine Ganzzahl (die die Position des Zeichens definiert) benötigt und es wird der entsprechende ASCII-Wert zurückgegeben.
Syntax
{%= charCodeAt(string,int) %}: int
Beispiel
Die folgende Funktion gibt den ASCII-Wert von o zurück, also 111.
{%= charCodeAt("some", 1)%}
Verknüpfen
Die Funktion concat kombiniert zwei Zeichenfolgen zu einer.
Syntax
{%= concat(string,string) %}
Beispiel
Mit der folgenden Funktion wird die Stadt und das Land eines Profils in einer einzigen Zeichenfolge kombiniert.
{%= concat(profile.homeAddress.city,profile.homeAddress.country) %}
Enthält
Mit der Funktion contains wird bestimmt, ob eine Zeichenfolge eine angegebene Unterzeichenfolge enthält.
Syntax
{%= contains(STRING_1, STRING_2, CASE_SENSITIVE) %}
STRING_1STRING_2CASE_SENSITIVEBeispiele
-
Mit der folgenden Funktion wird geprüft, ob der Vorname des Profils den Buchstaben A enthält (in Groß- oder Kleinschreibung). Ist dies der Fall, wird „true“ zurückgegeben, andernfalls wird „false“ zurückgegeben.
{%= contains(profile.person.name.firstName, "A", false) %} -
Die folgende Abfrage bestimmt unter Berücksichtigung der Groß-/Kleinschreibung, ob die E-Mail-Adresse der Person die Zeichenfolge „2010@gm“ enthält.
{%= contains(profile.person.emailAddress,"2010@gm") %}
Enthält nicht
Mit der Funktion doesNotContain wird bestimmt, ob eine Zeichenfolge eine angegebene Unterzeichenfolge nicht enthält.
Syntax
{%= doesNotContain(STRING_1, STRING_2, CASE_SENSITIVE)%}
STRING_1STRING_2CASE_SENSITIVEBeispiel
Die folgende Abfrage bestimmt unter Berücksichtigung der Groß-/Kleinschreibung, ob die E-Mail-Adresse der Person die Zeichenfolge „2010@gm“ nicht enthält.
{%= doesNotContain(profile.person.emailAddress,"2010@gm")%}
Endet nicht mit
Mit der Funktion doesNotEndWith wird bestimmt, ob eine Zeichenfolge nicht mit einer angegebenen Unterzeichenfolge endet.
Syntax
{%= doesNotEndWith(STRING_1, STRING_2, CASE_SENSITIVE)%}
{STRING_1}{STRING_2}{CASE_SENSITIVE}Beispiel
Die folgende Abfrage bestimmt bei Beachtung der Groß-/Kleinschreibung, ob die E-Mail-Adresse der Person nicht mit „.com“ endet.
doesNotEndWith(person.emailAddress,".com")
Beginnt nicht mit
Mit der Funktion doesNotStartWith wird bestimmt, ob eine Zeichenfolge nicht mit einer angegebenen Unterzeichenfolge beginnt.
Syntax
{%= doesNotStartWith(STRING_1, STRING_2, CASE_SENSITIVE)%}
{STRING_1}{STRING_2}{CASE_SENSITIVE}Beispiel
Die folgende Abfrage bestimmt bei Beachtung der Groß-/Kleinschreibung, ob der Personenname nicht mit „Joe“ beginnt.
{%= doesNotStartWith(person.name,"Joe")%}
Codieren 64
Die Funktion encode64 wird zum Codieren einer Zeichenfolge verwendet, um personenbezogene Daten (PI) beizubehalten, wenn diese z. B. in eine URL aufgenommen werden sollen.
Syntax
{%= encode64(string) %}
Endet mit
Mit der Funktion endsWith wird bestimmt, ob eine Zeichenfolge mit einer angegebenen Unterzeichenfolge endet.
Syntax
{%= endsWith(STRING_1, STRING_2, CASE_SENSITIVE) %}
{STRING_1}{STRING_2}{CASE_SENSITIVE}Beispiel
In der folgenden Abfrage wird unter Berücksichtigung der Groß-/Kleinschreibung bestimmt, ob die E-Mail-Adresse des Benutzers mit „.com“ endet.
{%= endsWith(person.emailAddress,".com") %}
Gleich
Mit der Funktion equals wird bestimmt, ob eine Zeichenfolge gleich der angegebenen Zeichenfolge ist, wobei zwischen Groß- und Kleinschreibung unterschieden wird.
Syntax
{%= equals(STRING_1, STRING_2) %}
{STRING_1}{STRING_2}Beispiel
Mit der folgenden Abfrage wird unter Berücksichtigung der Groß-/Kleinschreibung bestimmt, ob der Name der Person „John“ lautet.
{%=equals(profile.person.name,"John") %}
Gleich ohne Groß-/Kleinschreibung
Mit der Funktion equalsIgnoreCase wird bestimmt, ob eine Zeichenfolge gleich der angegebenen Zeichenfolge ist, wobei nicht zwischen Groß- und Kleinschreibung unterschieden wird.
Syntax
{%= equalsIgnoreCase(STRING_1, STRING_2) %}
{STRING_1}{STRING_2}Beispiel
Mit der folgenden Abfrage wird ohne Berücksichtigung der Groß-/Kleinschreibung bestimmt, ob der Name der Person „John“ lautet.
{%= equalsIgnoreCase(profile.person.name,"John") %}
E-Mail-Domain extrahieren
Die Funktion extractEmailDomain wird verwendet, um die Domain einer E-Mail-Adresse zu extrahieren.
Syntax
{%= extractEmailDomain(string) %}
Beispiel
Mit der folgenden Abfrage wird die E-Mail-Domain der persönlichen E-Mail-Adresse extrahiert.
{%= extractEmailDomain(profile.personalEmail.address) %}
Währung formatieren
Die Funktion formatCurrency wird verwendet, um eine beliebige Zahl in die entsprechende sprachabhängige Währungsdarstellung zu konvertieren, je nachdem, welches Gebietsschema als Zeichenfolge im zweiten Argument übergeben wurde.
Syntax
{%= formatCurrency(number/double,string) %}: string
Beispiel
Diese Abfrage gibt 56,00 £ zurück.
{%= formatCurrency(56L,"en_GB") %}
URL-Host abrufen
Die Funktion getUrlHost dient zum Abrufen des Host-Namens einer URL.
Syntax
{%= getUrlHost(string) %}: string
Beispiel
{%= getUrlHost("https://www.myurl.com/contact") %}
Gibt „www.myurl.com“ zurück
URL-Pfad abrufen
Die Funktion getUrlPath wird verwendet, um den Pfad nach dem Domain-Namen einer URL abzurufen.
Syntax
{%= getUrlPath(string) %}: string
Beispiel
{%= getUrlPath("https://www.myurl.com/contact.html") %}
Gibt „/contact.html“ zurück
URL-Protokoll abrufen
Die Funktion getUrlProtocol dient zum Abrufen des Protokolls einer URL.
Syntax
{%= getUrlProtocol(string) %}: string
Beispiel
{%= getUrlProtocol("https://www.myurl.com/contact.html") %}
Gibt „http“ zurück
Index von
Die Funktion indexOf wird verwendet, um die Position (im ersten Argument) des ersten Auftretens des zweiten Parameters zurückzugeben. Gibt -1 zurück, wenn keine Übereinstimmung vorliegt.
Syntax
{%= indexOf(STRING_1, STRING_2) %}: integer
{STRING_1}{STRING_2}Beispiel
{%= indexOf("hello world","world" ) %}
Gibt 6 zurück.
Ist leer
Mit der Funktion isEmpty wird ermittelt, ob eine Zeichenfolge leer ist.
Syntax
{%= isEmpty(string) %}
Beispiel
Die folgende Funktion gibt „true“ zurück, wenn die Mobiltelefonnummer des Profils leer ist. Andernfalls wird „false“ zurückgegeben.
{%= isEmpty(profile.mobilePhone.number) %}
Ist nicht leer
Die Funktion isNotEmpty wird verwendet, um zu bestimmen, ob eine Zeichenfolge nicht leer ist.
Syntax
{= isNotEmpty(string) %}: boolean
Beispiel
Die folgende Funktion gibt „true“ zurück, wenn die Mobiltelefonnummer des Profils nicht leer ist. Andernfalls wird „false“ zurückgegeben.
{%= isNotEmpty(profile.mobilePhone.number) %}
Letzter Index von
Die Funktion lastIndexOf wird verwendet, um die Position (im ersten Argument) des letzten Auftretens des zweiten Parameters zurückzugeben. Gibt -1 zurück, wenn keine Übereinstimmung vorliegt.
Syntax
{= lastIndexOf(STRING_1, STRING_2) %}: integer
{STRING_1}{STRING_2}Beispiel
{%= lastIndexOf("hello world","o" ) %}
Gibt 7 zurück.
Links kürzen
Die Funktion leftTrim wird verwendet, um Leerzeichen vom Anfang einer Zeichenfolge zu entfernen.
Syntax
{%= leftTrim(string) %}
Länge
Die Funktion length wird verwendet, um die Anzahl der Zeichen in einer Zeichenfolge oder einem Ausdruck abzurufen.
Syntax
{%= length(string) %}
Beispiel
Die folgende Funktion gibt die Länge des Stadtnamens des Profils zurück.
{%= length(profile.homeAddress.city) %}
Ist wie
Mit der Funktion like wird bestimmt, ob eine Zeichenfolge einem angegebenen Muster entspricht.
Syntax
{%= like(STRING_1, STRING_2) %}
{STRING_1}{STRING_2}Der Ausdruck, der mit der ersten Zeichenfolge übereinstimmen soll. Es werden zwei Sonderzeichen zum Erstellen eines Ausdrucks unterstützt: % und _.
%wird verwendet, um 0 oder mehr Zeichen zu repräsentieren._wird verwendet, um genau ein Zeichen zu repräsentieren.
Beispiel
In der folgenden Abfrage werden alle Städte abgerufen, in denen Profile leben und die das Muster „es“ enthalten.
{%= like(profile.homeAddress.city, "%es%")%}
Kleinbuchstaben
Mit der Funktion lowerCase wird eine Zeichenfolge in Kleinbuchstaben umgewandelt.
Syntax
{%= lowerCase(string) %}
Beispiel
Mit dieser Funktion wird der Vorname des Profils in Kleinbuchstaben umgewandelt.
{%= lowerCase(profile.person.name.firstName) %}
Stimmt überein mit
Mit der Funktion matches wird bestimmt, ob eine Zeichenfolge mit einem bestimmten regulären Ausdruck übereinstimmt. Weitere Informationen zu Übereinstimmungsmustern bei regulären Ausdrücken finden Sie in diesem Dokument.
Syntax
{%= matches(STRING_1, STRING_2) %}
Beispiel
Die folgende Abfrage bestimmt, ob der Name der Person ohne Unterscheidung der Groß-/Kleinschreibung mit „John“ beginnt.
{%= matches(person.name.,"(?i)^John") %}
Maskieren
Die Funktion Mask wird verwendet, um einen Teil einer Zeichenfolge durch „X“-Zeichen zu ersetzen.
Syntax
{%= mask(string,integer,integer) %}
Beispiel
Die folgende Abfrage ersetzt die Zeichenfolge „123456789“ durch „X“, mit Ausnahme des ersten und der letzten beiden Zeichen.
{%= mask("123456789",1,2) %}
Die Abfrage gibt 1XXXXXX89 zurück.
MD5
Die Funktion md5 wird verwendet, um den MD5-Hash einer Zeichenfolge zu berechnen und zurückzugeben.
Syntax
{%= md5(string) %}: string
Beispiel
{%= md5("hello world") %}
Gibt „5eb63bbbe01eeed093cb22bb8f5acdc3“ zurück
Ungleich
Mit der Funktion notEqualTo wird bestimmt, ob eine Zeichenfolge nicht gleich der angegebenen Zeichenfolge ist.
Syntax
{%= notEqualTo(STRING_1, STRING_2) %}
{STRING_1}{STRING_2}Beispiel
Die folgende Abfrage bestimmt bei Beachtung der Groß-/Kleinschreibung, ob der Name der Person nicht „John“ lautet.
{%= notEqualTo(profile.person.name,"John") %}
Entspricht nicht (Groß-/Kleinschreibung ignorieren)
Die Funktion notEqualWithIgnoreCase wird verwendet, um zwei Zeichenfolgen zu vergleichen, wobei Groß-/Kleinschreibung ignoriert wird.
Syntax
{= notEqualWithIgnoreCase(STRING_1,STRING_2) %}: boolean
{STRING_1}{STRING_2}Beispiel
Die folgende Abfrage ermittelt, ob der Name der Person nicht „john“ lautet (ohne Berücksichtigung von Groß-/Kleinschreibung).
{%= notEqualTo(profile.person.name,"john") %}
Gruppe regelmäßiger Ausdrücke
Die Funktion Group wird verwendet, um spezifische Informationen basierend auf dem bereitgestellten regulären Ausdruck zu extrahieren.
Syntax
{%= regexGroup(STRING, EXPRESSION, GROUP) %}
{STRING}{EXPRESSION}{GROUP}Beispiel
Die folgende Abfrage wird verwendet, um den Domain-Namen aus einer E-Mail-Adresse zu extrahieren.
{%= regexGroup(emailAddress,"@(\\w+)", 1) %}
Ersetzen
Die Funktion replace wird verwendet, um eine bestimmte Unterzeichenfolge in einer Zeichenfolge durch eine andere Unterzeichenfolge zu ersetzen.
Syntax
{%= replace(STRING_1,STRING_2,STRING_3) %}:string
{STRING_1}{STRING_2}{STRING_3}Beispiel
{%= replace("Hello John, here is your monthly newsletter!","John","Mark") %}
Gibt „Hallo Mark, hier ist dein monatlicher Newsletter!“ zurück.
Alle ersetzen
Die Funktion replaceAll wird verwendet, um alle Unterzeichenfolgen eines Textes, die mit dem „Regex“-Ausdruck übereinstimmen, durch die angegebene literale „Ersatz“-Zeichenfolge zu ersetzen. Regex hat eine besondere Handhabung für „\“ und „+“, und alle Regex-Ausdrücke folgen der PQL-Escaping-Strategie. Die Ersetzung erfolgt vom Anfang der Zeichenfolge zum Ende, z. B. führt ein Ersetzen von „aa“ in der Zeichenfolge „aaa“ durch „b“ zu „ba“ und nicht zu „ab“.
Syntax
{%= replaceAll(string,string,string) %}
NOTE//). Spezielle Regex-Zeichen sind: [., +, *, ?, ^, $, (, ), [,], {, }, |, .]Rechts kürzen
Mit der Funktion rightTrim werden Leerzeichen vom Ende einer Zeichenfolge entfernt.
Syntax
{%= rightTrim(string) %}
Teilen
Die Funktion split wird verwendet, um eine Zeichenfolge durch ein bestimmtes Zeichen zu teilen.
Syntax
{%= split(string,string) %}
Beginnt mit
Mit der Funktion startsWith wird bestimmt, ob eine Zeichenfolge mit einer angegebenen Unterzeichenfolge beginnt.
Syntax
{%= startsWith(STRING_1, STRING_2, CASE_SENSITIVE) %}
{STRING_1}{STRING_2}{CASE_SENSITIVE}Beispiel
Die folgende Abfrage bestimmt bei Beachtung der Groß-/Kleinschreibung, ob der Name der Person mit „Joe“ beginnt.
{%= startsWith(person.name,"Joe") %}
Zeichenfolge zu Datum
Die Funktion stringToDate konvertiert einen Zeichenfolgenwert in einen Datums-/Uhrzeitwert. Es gibt zwei Argumente: Zeichenfolgendarstellung eines Datums/Uhrzeit und Zeichenfolgendarstellung des Formatierers.
Syntax
{= stringToDate("date-time value","formatter" %}
Beispiel
{= stringToDate("2023-01-10 23:13:26", "yyyy-MM-dd HH:mm:ss") %}
Zeichenfolge zu Ganzzahl
Die Funktion string_to_integer wird verwendet, um einen Zeichenfolgenwert in einen ganzzahligen Wert zu konvertieren.
Syntax
{= string_to_integer(string) %}: int
Zeichenfolge zu Zahl
Die Funktion stringToNumber wird verwendet, um eine Zeichenfolge in eine Zahl zu konvertieren. Bei einer ungültigen Eingabe wird dieselbe Zeichenfolge als Ausgabe zurückgegeben.
Syntax
{%= stringToNumber(string) %}: double
Teilzeichenfolge
Die Funktion Count string wird verwendet, um die Unterzeichenfolge des Zeichenfolgenausdrucks zwischen dem Anfangsindex und dem Endindex zurückzugeben.
Syntax
{= substr(string, integer, integer) %}: string
Titelschreibweise
Die Funktion titleCase wird verwendet, um die ersten Buchstaben jedes Wortes einer Zeichenfolge großzuschreiben.
Syntax
{%= titleCase(string) %}
Beispiel
Wenn die Person in der Washington High Street lebt, gibt diese Funktion „Washington High Street“ zurück.
{%= titleCase(profile.person.location.Street) %}
Zu booleschem Wert
Die Funktion toBool wird verwendet, um einen Argumentwert je nach Typ in einen booleschen Wert zu konvertieren.
Syntax
{= toBool(string) %}: boolean
Zu Uhrzeit-/Datumsangabe
Die Funktion toDateTime wird verwendet, um die Zeichenfolge in ein Datum zu konvertieren. Bei einer ungültigen Eingabe wird als Ausgabe das Epoch-Datum zurückgegeben.
Syntax
{%= toDateTime(string, string) %}: date-time
Nur zu Datums-/Uhrzeitangabe
Die Funktion toDateTimeOnly wird verwendet, um einen Argumentwert in einen Datums-/Uhrzeitwert zu konvertieren. Bei einer ungültigen Eingabe wird als Ausgabe das Epoch-Datum zurückgegeben. Diese Funktion akzeptiert die Feldtypen string, date, long und int.
Syntax
{%= toDateTimeOnly(string/date/long/int) %}: date-time
Kürzen
Die Funktion trim entfernt alle Leerzeichen vom Anfang und Ende einer Zeichenfolge.
Syntax
{%= trim(string) %}
Großbuchstaben
Mit der Funktion upperCase wird eine Zeichenfolge in Großbuchstaben umgewandelt.
Syntax
{%= upperCase(string) %}
Beispiel
Mit dieser Funktion wird der Nachname des Profils in Großbuchstaben umgewandelt.
{%= upperCase(profile.person.name.lastName) %}
URL-Decodierung
Die Funktion urlDecode wird zum Decodieren einer URL-codierten Zeichenfolge verwendet.
Syntax
{%= urlDecode(string) %}: string
URL-Codierung
Die Funktion Count only null wird verwendet, um eine Zeichenfolge mit einer URL zu codieren.
Syntax
{%= urlEncode(string) %}: string