Strängfunktioner string

Lär dig hur du använder strängfunktioner i personaliseringsredigeraren.

Camera Case camelCase

Funktionen camelCase ändrar den första bokstaven i varje ord i en sträng till versal.

Syntax

{%= camelCase(string)%}

Exempel

Med följande funktion infogas den första bokstaven i ordet i profilens gatuadress.

{%= camelCase(profile.homeAddress.street) %}

Teckenkod på char-code-at

Funktionen charCodeAt returnerar ASCII-värdet för ett tecken, precis som funktionen charCodeAt i JavaScript. Den tar en sträng och ett heltal (som definierar positionen för tecknet) som indataargument och returnerar motsvarande ASCII-värde.

Syntax

{%= charCodeAt(string,int) %}: int

Exempel

Följande funktion returnerar ASCII-värdet för o, d.v.s. 11.

{%= charCodeAt("some", 1)%}

Concat concate

Funktionen concat kombinerar två strängar till en.

Syntax

{%= concat(string,string) %}

Exempel

Följande funktion kombinerar profilens ort och land i en enda sträng.

{%= concat(profile.homeAddress.city,profile.homeAddress.country) %}

Innehåller contains

Funktionen contains används för att avgöra om en sträng innehåller en angiven delsträng.

Syntax

{%= contains(STRING_1, STRING_2, CASE_SENSITIVE) %}

Exempel

Innehåller inte doesNotContain

Funktionen doesNotContain används för att avgöra om en sträng inte innehåller en angiven delsträng.

Syntax

{%= doesNotContain(STRING_1, STRING_2, CASE_SENSITIVE)%}

Exempel

Följande fråga avgör, med skiftlägeskänslighet, om personens e-postadress inte innehåller strängen "2010@gm".

{%= doesNotContain(profile.person.emailAddress,"2010@gm")%}

Slutar inte med doesNotEndWith

Funktionen doesNotEndWith används för att avgöra om en sträng inte avslutas med en angiven delsträng.

Syntax

{%= doesNotEndWith(STRING_1, STRING_2, CASE_SENSITIVE)%}

Exempel

Följande fråga avgör, med skiftlägeskänslighet, om personens e-postadress inte avslutas med ".com".

doesNotEndWith(person.emailAddress,".com")

Börjar inte med doesNotStartWith

Funktionen doesNotStartWith används för att avgöra om en sträng inte börjar med en angiven delsträng.

Syntax

{%= doesNotStartWith(STRING_1, STRING_2, CASE_SENSITIVE)%}

Exempel

Följande fråga avgör, med skiftlägeskänslighet, om personens namn inte börjar med "Joe".

{%= doesNotStartWith(person.name,"Joe")%}

Koda 64 encode64

Funktionen encode64 används för att koda en sträng för att bevara personlig information (PI) om den ska inkluderas t.ex. i en URL.

Syntax

{%= encode64(string) %}

Slutar med endsWith

Funktionen endsWith används för att avgöra om en sträng avslutas med en angiven delsträng.

Syntax

{%= endsWith(STRING_1, STRING_2, CASE_SENSITIVE) %}

Exempel

Följande fråga avgör, med skiftlägeskänslighet, om personens e-postadress slutar med ".com".

{%= endsWith(person.emailAddress,".com") %}

Lika med equals

Funktionen equals används för att avgöra om en sträng är lika med den angivna strängen, med skiftlägeskänslighet.

Syntax

{%= equals(STRING_1, STRING_2) %}

Exempel

Följande fråga avgör, med skiftlägeskänslighet, om personens namn är "John".

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

Lika med Ignorera skiftläge equalsIgnoreCase

Funktionen equalsIgnoreCase används för att avgöra om en sträng är lika med den angivna strängen, utan skiftlägeskänslighet.

Syntax

{%= equalsIgnoreCase(STRING_1, STRING_2) %}

Exempel

Följande fråga avgör, utan skiftlägeskänslighet, om personens namn är "John".

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

Extract Email Domain extractEmailDomain

Funktionen extractEmailDomain används för att hämta domänen för en e-postadress.

Syntax

{%= extractEmailDomain(string) %}

Exempel

Följande fråga extraherar e-postdomänen för den personliga e-postadressen.

{%= extractEmailDomain(profile.personalEmail.address) %}

Formatera valuta format-currency

Funktionen formatCurrency används för att konvertera valfritt tal till motsvarande språkkänsliga valutarepresentation beroende på vilket språk som skickas som en sträng i det andra argumentet.

Syntax

{%= formatCurrency(number/double,string) %}: string

Exempel

Frågan returnerar 56,00 GBP

{%= formatCurrency(56L,"en_GB") %}

Hämta URL-värd get-url-host

Funktionen getUrlHost används för att hämta värdnamnet för en URL.

Syntax

{%= getUrlHost(string) %}: string

Exempel

{%= getUrlHost("https://www.myurl.com/contact") %}

Returnerar "www.myurl.com"

Hämta URL-sökväg get-url-path

Funktionen getUrlPath används för att hämta sökvägen efter domännamnet för en URL.

Syntax

{%= getUrlPath(string) %}: string

Exempel

{%= getUrlPath("https://www.myurl.com/contact.html") %}

Returnerar "/contact.html"

Hämta URL-protokoll get-url-protocol

Funktionen getUrlProtocol används för att hämta protokollet för en URL.

Syntax

{%= getUrlProtocol(string) %}: string

Exempel

{%= getUrlProtocol("https://www.myurl.com/contact.html") %}

Returnerar "http"

index för index-of

Funktionen indexOf används för att returnera positionen (i det första argumentet) för den första förekomsten av den andra parametern. Returnerar -1 om det inte finns någon matchning.

Syntax

{%= indexOf(STRING_1, STRING_2) %}: integer

Exempel

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

Returnerar 6.

Är tom isEmpty

Funktionen isEmpty används för att avgöra om en sträng är tom.

Syntax

{%= isEmpty(string) %}

Exempel

Följande funktion returnerar 'true' om profilens mobiltelefonnummer är tomt. Annars returneras "false".

{%= isEmpty(profile.mobilePhone.number) %}

Är inte tom is-not-empty

Funktionen isNotEmpty används för att avgöra om en sträng inte är tom.

Syntax

{= isNotEmpty(string) %}: boolean

Exempel

Följande funktion returnerar 'true' om profilens mobiltelefonnummer inte är tomt. Annars returneras "false".

{%= isNotEmpty(profile.mobilePhone.number) %}

Senaste index för last-index-of

Funktionen lastIndexOf används för att returnera positionen (i det första argumentet) för den sista förekomsten av den andra parametern. Returnerar -1 om det inte finns någon matchning.

Syntax

{= lastIndexOf(STRING_1, STRING_2) %}: integer

Exempel

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

Returnerar 7.

Vänster trimning leftTrim

Funktionen leftTrim används för att ta bort blanksteg från början av en sträng.

Syntax

{%= leftTrim(string) %}

Längd length

Funktionen length används för att hämta antalet tecken i en sträng eller ett uttryck.

Syntax

{%= length(string) %}

Exempel

Följande funktion returnerar längden på profilens stadsnamn.

{%= length(profile.homeAddress.city) %}

Gilla like

Funktionen like används för att avgöra om en sträng matchar ett angivet mönster.

Syntax

{%= like(STRING_1, STRING_2) %}

Exempel

Följande fråga hämtar alla städer där profiler som innehåller mönstret "es" finns.

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

Gemener lower

Funktionen lowerCase konverterar en sträng till gemener.

Syntax

{%= lowerCase(string) %}

Exempel

Den här funktionen konverterar profilens förnamn till gemener.

{%= lowerCase(profile.person.name.firstName) %}

Matchar matches

Funktionen matches används för att avgöra om en sträng matchar ett visst reguljärt uttryck. Mer information om att matcha mönster i reguljära uttryck finns i det här dokumentet.

Syntax

{%= matches(STRING_1, STRING_2) %}

Exempel

Följande fråga avgör, utan skiftlägeskänslighet, om personens namn börjar med "John".

{%= matches(person.name.,"(?i)^John") %}

Mask mask

Funktionen Mask används för att ersätta en del av en sträng med X-tecken.

Syntax

{%= mask(string,integer,integer) %}

Exempel

Följande fråga ersätter strängen "123456789" med "X"-tecken, med undantag för de första och de sista två tecknen.

{%= mask("123456789",1,2) %}

Frågan returnerar 1XXXXXX89.

MD5 md5

Funktionen md5 används för att beräkna och returnera md5-hash för en sträng.

Syntax

{%= md5(string) %}: string

Exempel

{%= md5("hello world") %}

Returnerar "5eb63bbbe01eed093cb22bb8f5acdc3"

Inte lika med notEqualTo

Funktionen notEqualTo används för att avgöra om en sträng inte är lika med den angivna strängen.

Syntax

{%= notEqualTo(STRING_1, STRING_2) %}

Exempel

Följande fråga avgör, med skiftlägeskänslighet, om personens namn inte är"John".

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

Inte lika med Ignorera skiftläge not-equal-with-ignore-case

Funktionen notEqualWithIgnoreCase används för att jämföra två strängar utan skiftläge.

Syntax

{= notEqualWithIgnoreCase(STRING_1,STRING_2) %}: boolean

Exempel

Följande fråga avgör om personens namn inte är "john", utan skiftlägeskänslighet.

{%= notEqualTo(profile.person.name,"john") %}

Grupp för reguljära uttryck regexGroup

Funktionen Group används för att extrahera specifik information baserat på det reguljära uttrycket som anges.

Syntax

{%= regexGroup(STRING, EXPRESSION, GROUP) %}

Exempel

Följande fråga används för att extrahera domännamnet från en e-postadress.

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

Ersätt replace

Funktionen replace används för att ersätta en given delsträng i en sträng med en annan delsträng.

Syntax

{%= replace(STRING_1,STRING_2,STRING_3) %}:string

Exempel

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

Returnerar"Hello Mark, här kommer ditt månatliga nyhetsbrev!"

Ersätt alla replaceAll

Funktionen replaceAll används för att ersätta alla delsträngar för en text som matchar uttrycket "regex" med den angivna strängen "teckenersättning". Regex har specialhantering av "" och "+" och alla regex-uttryck följer PQL escape-strategi. Ersättningen fortsätter från början av strängen till slutet, t.ex. om"a" ersätts med"b" i strängen"aaa" resulterar det i"ba" i stället för"ab".

Syntax

{%= replaceAll(string,string,string) %}

Högertrimning rightTrim

Funktionen rightTrim används för att ta bort tomrum från strängens slut.

Syntax

{%= rightTrim(string) %}

Dela split

Funktionen split används för att dela en sträng med ett givet tecken.

Syntax

{%= split(string,string) %}

Börjar med startsWith

Funktionen startsWith används för att avgöra om en sträng börjar med en angiven delsträng.

Syntax

{%= startsWith(STRING_1, STRING_2, CASE_SENSITIVE) %}

Exempel

Följande fråga avgör, med skiftlägeskänslighet, om personens namn börjar med "Joe".

{%= startsWith(person.name,"Joe") %}

Sträng till datum string-to-date

Funktionen stringToDate konverterar ett strängvärde till ett datum/tid-värde. Den har två argument: strängbeteckning för ett datum- och tidsvärde samt strängbeteckning för formateringen.

Syntax

{= stringToDate("date-time value","formatter" %}

Exempel

{= stringToDate("2023-01-10 23:13:26", "yyyy-MM-dd HH:mm:ss") %}

Sträng till heltal string-to-integer

Funktionen string_to_integer används för att konvertera ett strängvärde till ett heltalsvärde.

Syntax

{= string_to_integer(string) %}: int

Sträng till tal string-to-number

Funktionen stringToNumber används för att konvertera en sträng till tal. Den returnerar samma sträng som utdata för ogiltiga indata.

Syntax

{%= stringToNumber(string) %}: double

Delsträng sub-string

Funktionen Count string används för att returnera delsträngen för stränguttrycket mellan startindexet och slutindexvärdet.
Syntax

{= substr(string, integer, integer) %}: string

Inledande versal titleCase

Funktionen titleCase används för att ge inledande versal för varje ord i en sträng.

Syntax

{%= titleCase(string) %}

Exempel

Om personen bor i Washington High Street, returnerar den här funktionen Washington High Street.

{%= titleCase(profile.person.location.Street) %}

Till boolesk to-bool

Funktionen toBool används för att konvertera ett argumentvärde till ett booleskt värde, beroende på dess typ.

Syntax

{= toBool(string) %}: boolean

Till datum och tid to-date-time

Funktionen toDateTime används för att konvertera en sträng till ett datum. Det returnerar epokdatumet som utdata för ogiltiga indata.

Syntax

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

Endast till datum och tid to-date-time-only

Funktionen toDateTimeOnly används för att konvertera ett argumentvärde till ett värde som bara gäller för datum och tid. Det returnerar epokdatumet som utdata för ogiltiga indata. Den här funktionen accepterar fälttyperna string, date, long och int.

Syntax

{%= toDateTimeOnly(string/date/long/int) %}: date-time

Rensa trim

Funktionen trim tar bort alla tomrum från början och slutet av en sträng.

Syntax

{%= trim(string) %}

Versaler upper

Funktionen upperCase konverterar en sträng till versaler.

Syntax

{%= upperCase(string) %}

Exempel

Den här funktionen konverterar profilens efternamn till versaler.

{%= upperCase(profile.person.name.lastName) %}

URL-avkodning url-decode

Funktionen urlDecode används för att avkoda en URL-kodad sträng.

Syntax

{%= urlDecode(string) %}: string

URL-kodning url-encode

Funktionen Count only null används för att URL-koda en sträng.

Syntax

{%= urlEncode(string) %}: string