Zeichenfolgen-Funktionen string
Erfahren Sie, wie Sie im Personalisierungseditor Zeichenfolgenfunktionen verwenden können.
Binnenmajuskel camelCase
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 char-code-at
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 concate
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 contains
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.
code language-sql {%= 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.
code language-sql {%= contains(profile.person.emailAddress,"2010@gm") %}
Enthält nicht doesNotContain
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 doesNotEndWith
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 doesNotStartWith
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 encode64
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 endsWith
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 equals
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 equalsIgnoreCase
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 extractEmailDomain
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 format-currency
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 get-url-host
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 get-url-path
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 get-url-protocol
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 index-of
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 isEmpty
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 is-not-empty
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 last-index-of
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 leftTrim
Die Funktion leftTrim wird verwendet, um Leerzeichen vom Anfang einer Zeichenfolge zu entfernen.
Syntax
{%= leftTrim(string) %}
Länge length
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 like
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 lower
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 matches
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 mask
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 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 notEqualTo
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) not-equal-with-ignore-case
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 regexGroup
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 replace
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 replaceAll
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) %}
//). Spezielle Regex-Zeichen sind: [., +, *, ?, ^, $, (, ), [,], {, }, |, .]Rechts kürzen rightTrim
Mit der Funktion rightTrim werden Leerzeichen vom Ende einer Zeichenfolge entfernt.
Syntax
{%= rightTrim(string) %}
Teilen split
Die Funktion split wird verwendet, um eine Zeichenfolge durch ein bestimmtes Zeichen zu teilen.
Syntax
{%= split(string,string) %}
Beginnt mit startsWith
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 string-to-date
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 string-to-integer
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 string-to-number
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 sub-string
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 titleCase
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 to-bool
Die Funktion toBool wird verwendet, um einen Argumentwert je nach Typ in einen booleschen Wert zu konvertieren.
Syntax
{= toBool(string) %}: boolean
Zu Uhrzeit-/Datumsangabe to-date-time
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 to-date-time-only
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 trim
Die Funktion trim entfernt alle Leerzeichen vom Anfang und Ende einer Zeichenfolge.
Syntax
{%= trim(string) %}
Großbuchstaben upper
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 url-decode
Die Funktion urlDecode wird zum Decodieren einer URL-codierten Zeichenfolge verwendet.
Syntax
{%= urlDecode(string) %}: string
URL-Codierung url-encode
Die Funktion Count only null wird verwendet, um eine Zeichenfolge mit einer URL zu codieren.
Syntax
{%= urlEncode(string) %}: string