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) %}
STRING_1STRING_2CASE_SENSITIVEExempel
-
Följande funktion kontrollerar om profilens förnamn innehåller bokstaven A (i versaler eller gemener). Om så är fallet returneras true, annars returneras false.
code language-sql {%= contains(profile.person.name.firstName, "A", false) %} -
Följande fråga avgör, med skiftlägeskänslighet, om personens e-postadress innehåller strängen "2010@gm".
code language-sql {%= contains(profile.person.emailAddress,"2010@gm") %}
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)%}
STRING_1STRING_2CASE_SENSITIVEExempel
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)%}
{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)%}
{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) %}
{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) %}
{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) %}
{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
{STRING_1}{STRING_2}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
{STRING_1}{STRING_2}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) %}
{STRING_1}{STRING_2}Det uttryck som ska matchas mot den första strängen. Det finns två specialtecken som stöds för att skapa ett uttryck: % och _.
%används för att representera noll eller flera tecken._används för att representera exakt ett tecken.
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) %}
{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
{STRING_1}{STRING_2}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) %}
{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
{STRING_1}{STRING_2}{STRING_3}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) %}
//). Specialregextecken är: [., +, *, ?, ^, $, (, ), [,], {, }, |, .]Högertrimning rightTrim
Funktionen rightTrim tar bort blanksteg från slutet av en sträng.
Syntax
{%= rightTrim(string) %}
SHA256 sha256
Funktionen SHA256 beräknar och returnerar sha256-hash för en sträng.
Syntax
{%= sha256(string) %} : string
Exempel
{%= sha256("Eliechxh")%}
returnerar: 0b0b207880b999adaad6231026abf87caa30760b6f326b21727b61139332257d
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) %}
{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