字符串函数

了解如何在表达式编辑器中使用字符串函数。

驼峰式大小写

此 camelCase 函数将字符串中每个单词的第一个字母转换为大写。

语法

{%= camelCase(string)%}

示例

以下函数会将用户档案的街道地址中的第一个单词变为大写。

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

字符代码位于

此 charCodeAt 函数返回字符的ASCII值，与JavaScript中的charCodeAt函数类似。 它采用字符串和整数（定义字符的位置）作为输入参数，并返回相应的ASCII值。

语法

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

示例

以下函数返回o的ASCII值，即111。

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

Concat

此 concat 函数将两个字符串组合在一起。

语法

{%= concat(string,string) %}

示例

以下函数将用户档案城市和国家/地区组合在一个字符串中。

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

Contains

此 contains 函数用于确定一个字符串是否包含指定的子字符串。

语法

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

参数	描述
STRING_1	要检查的字符串。
STRING_2	要在第一个字符串中搜索的字符串。
CASE_SENSITIVE	用于确定检查是否区分大小写，的可选参数。 可能的值： true （默认） / false。

示例

• 以下函数将检查用户档案名字是否包含字母A（大写或小写）。 如果是这种情况，将返回“true”，否则将返回“false”。

  {%= contains(profile.person.name.firstName, "A", false) %}
  

• 以下查询区分大小写确定人员的电子邮件地址是否包含字符串“2010@gm”。

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

不包含

此 doesNotContain 函数用于确定一个字符串是否不包含指定的子字符串。

语法

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

参数	描述
STRING_1	要检查的字符串。
STRING_2	要在第一个字符串中搜索的字符串。
CASE_SENSITIVE	用于确定检查是否区分大小写，的可选参数。 可能的值： true （默认） / false。

示例

以下查询区分大小写确定人员的电子邮件地址是否不包含字符串“2010@gm”。

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

结尾不是

此 doesNotEndWith 函数用于确定一个字符串是否不以指定的子字符串结尾。

语法

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

参数	描述
{STRING_1}	要检查的字符串。
{STRING_2}	要在第一个字符串中搜索的字符串。
{CASE_SENSITIVE}	用于确定检查是否区分大小写，的可选参数。 可能的值： true （默认） / false。

示例

以下查询区分大小写确定人员的电子邮件地址是否不以“.com”结尾。

doesNotEndWith(person.emailAddress,".com")

开头不是

此 doesNotStartWith 函数用于确定一个字符串是否不以指定的子字符串开头。

语法

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

参数	描述
{STRING_1}	要检查的字符串。
{STRING_2}	要在第一个字符串中搜索的字符串。
{CASE_SENSITIVE}	用于确定检查是否区分大小写，的可选参数。 可能的值： true （默认） / false。

示例

以下查询区分大小写确定人员的姓名是否不以“Joe”开头。

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

编码64

此 encode64 函数用于对字符串进行编码，以保留个人信息(PI)（例如，如果包含在URL中）。

语法

{%= encode64(string) %}

结束于

此 endsWith 函数用于确定一个字符串是否以指定的子字符串结尾。

语法

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

参数	描述
{STRING_1}	要检查的字符串。
{STRING_2}	要在第一个字符串中搜索的字符串。
{CASE_SENSITIVE}	用于确定检查是否区分大小写，的可选参数。 可能的值： true （默认） / false。

示例

以下查询区分大小写确定人员的电子邮件地址是否以“.com”结尾。

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

等于

此 equals 函数用于确定一个字符串是否等于指定的字符串（区分大小写）。

语法

{%= equals(STRING_1, STRING_2) %}

参数	描述
{STRING_1}	要检查的字符串。
{STRING_2}	要与第一个字符串进行比较的字符串。

示例

以下查询区分大小写确定人员姓名是否为“John”。

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

Equals Ignore Case

此 equalsIgnoreCase 函数用于确定一个字符串是否等于指定的字符串，不区分大小写。

语法

{%= equalsIgnoreCase(STRING_1, STRING_2) %}

参数	描述
{STRING_1}	要检查的字符串。
{STRING_2}	要与第一个字符串进行比较的字符串。

示例

以下查询在不区分大小写的情况下确定人员姓名是否为“John”。

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

提取电子邮件域

此 extractEmailDomain 函数用于提取电子邮件地址的域。

语法

{%= extractEmailDomain(string) %}

示例

以下查询提取个人电子邮件地址的电子邮件域。

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

设置货币格式

此 formatCurrency 函数用于将任何数字转换为相应的语言敏感型货币表示形式，具体取决于在第二个参数中作为字符串传递的区域设置。

语法

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

示例

此查询返回56.00英镑

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

获取url主机

此 getUrlHost 函数用于检索URL的主机名。

语法

{%= getUrlHost(string) %}: string

示例

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

返回“www.myurl.com”

获取URL路径

此 getUrlPath 函数用于检索URL的域名之后的路径。

语法

{%= getUrlPath(string) %}: string

示例

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

返回“/contact.html”

Get url protocol

此 getUrlProtocol 函数用于检索URL的协议。

语法

{%= getUrlProtocol(string) %}: string

示例

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

返回“http”

索引：

此 indexOf 函数用于返回第二个参数在第一个参数中第一次出现的位置。 如果没有匹配项，则返回–1。

语法

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

参数	描述
{STRING_1}	要检查的字符串。
{STRING_2}	要在第一个参数中搜索的字符串

示例

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

返回6。

为空

此 isEmpty 函数用于确定一个字符串是否为空。

语法

{%= isEmpty(string) %}

示例

如果个人资料的手机号码为空，则以下函数返回“true”。 否则，将返回“false”。

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

不为空

此 isNotEmpty 函数用于确定一个字符串是否不为空。

语法

{= isNotEmpty(string) %}: boolean

示例

如果个人资料的手机号码不为空，则以下函数返回“true”。 否则，将返回“false”。

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

最后索引：

此 lastIndexOf 函数用于返回第二个参数在第一个参数中最后一次出现的位置。 如果没有匹配项，则返回–1。

语法

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

参数	描述
{STRING_1}	要检查的字符串。
{STRING_2}	要在第一个参数中搜索的字符串

示例

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

返回7。

Left trim

此 leftTrim 函数用于去除字符串开头的空格。

语法

{%= leftTrim(string) %}

长度

此 length 函数用于获取字符串或表达式中的字符数。

语法

{%= length(string) %}

示例

以下函数返回用户档案的城市名称的长度。

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

点赞

此 like 函数用于确定一个字符串是否与指定的模式匹配。

语法

{%= like(STRING_1, STRING_2) %}

参数	描述
{STRING_1}	要检查的字符串。
{STRING_2}	要与第一个字符串匹配的表达式。 创建表达式时支持使用两个特殊字符： % 和 _. % 用于表示零个或更多字符。 _ 用于恰好表示一个字符。

示例

以下查询检索用户档案所在的所有城市，其中包含“es”模式。

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

小写

此 lowerCase 函数将字符串转换为小写字母。

语法

{%= lowerCase(string) %}

示例

此函数将用户档案的名字转换为小写字母。

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

匹配

此 matches 函数用于确定一个字符串是否与特定的正则表达式匹配。 请参阅 本文档 有关正则表达式中匹配模式的详细信息。

语法

{%= matches(STRING_1, STRING_2) %}

示例

以下查询在不区分大小写的情况下确定人员的姓名是否以“John”开头。

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

蒙版

此 Mask 函数可将字符串的一部分替换为“X”字符。

语法

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

示例

以下查询将“123456789”字符串替换为“X”字符，但前两个字符和后两个字符除外。

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

查询返回 1XXXXXX89.

MD5

此 md5 函数用于计算和返回字符串的md5哈希值。

语法

{%= md5(string) %}: string

示例

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

返回“5eb63bbe01eeed093cb22bb8f5acdc3”

不等于

此 notEqualTo 函数用于确定一个字符串是否不等于指定的字符串。

语法

{%= notEqualTo(STRING_1, STRING_2) %}

参数	描述
{STRING_1}	要检查的字符串。
{STRING_2}	要与第一个字符串进行比较的字符串。

示例

以下查询区分大小写确定人员姓名是否为“John”。

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

不等于，忽略大小写

此 notEqualWithIgnoreCase 函数用于比较两个字符串，忽略大小写。

语法

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

参数	描述
{STRING_1}	要检查的字符串。
{STRING_2}	要与第一个字符串进行比较的字符串。

示例

以下查询确定人员姓名是否为“john”，不区分大小写。

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

正则表达式组

此 Group 函数用于根据提供的正则表达式提取特定信息。

语法

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

参数	描述
{STRING}	要检查的字符串。
{EXPRESSION}	要与第一个字符串匹配的正则表达式。
{GROUP}	要匹配的表达式组。

示例

以下查询用于从电子邮件地址中提取域名。

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

替换

此 replace 函数用于将字符串中的给定子字符串替换为另一个子字符串。

语法

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

参数	描述
{STRING_1}	必须替换子字符串的字符串。
{STRING_2}	要替换的子字符串。
{STRING_3}	替换子字符串。

示例

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

返回“Hello Mark，这是您每月的新闻稿！”

全部替换

此 replaceAll 函数用于将匹配“regex”表达式的文本的所有子字符串替换为指定的文本“replacement”字符串。 正则表达式对“\”和“+”有特殊处理，所有正则表达式都遵循PQL转义策略。 例如，替换操作从字符串的开头到结尾进行，将字符串“aaa”中的“aa”替换为“b”将导致“ba”而不是“ab”。

语法

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

Right trim

此 rightTrim 函数去除字符串末尾的空格。

语法

{%= rightTrim(string) %}

拆分

此 split 函数用于按给定字符拆分字符串。

语法

{%= split(string,string) %}

开始于

此 startsWith 函数用于确定一个字符串是否以指定的子字符串开头。

语法

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

参数	描述
{STRING_1}	要检查的字符串。
{STRING_2}	要在第一个字符串中搜索的字符串。
{CASE_SENSITIVE}	用于确定检查是否区分大小写，的可选参数。 默认情况下，该参数设置为true。

示例

以下查询区分大小写确定人员的姓名是否以“Joe”开头。

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

String to date

此 stringToDate 函数将一个字符串值转换为日期时间值。 它采用两个参数：日期时间的字符串表示和格式化器的字符串表示。

语法

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

示例

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

String to integer

此 string_to_integer 函数用于将字符串值转换为整数值。

语法

{= string_to_integer(string) %}: int

字符串到数字

此 stringToNumber 函数用于将字符串转换为数字。 对于无效的输入，它返回相同的字符串作为输出。

语法

{%= stringToNumber(string) %}: double

子字符串

此 Count string 函数用于返回字符串表达式在开始索引和结束索引之间的子字符串。
语法

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

字首大写

此 titleCase 函数用于将字符串中每个单词的首字母大写。

语法

{%= titleCase(string) %}

示例

如果该人住在华盛顿高街，则此函数将返回华盛顿高街。

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

To Bool

此 toBool 函数用于将参数值转换为布尔值，具体取决于其类型。

语法

{= toBool(string) %}: boolean

To Date Time

此 toDateTime 函数用于将字符串转换为日期。 对于无效的输入，它返回纪元日期作为输出。

语法

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

To Date Time Only

此 toDateTimeOnly 函数用于将参数值转换为仅日期时间值。 对于无效的输入，它返回纪元日期作为输出。 此函数接受字符串、日期、长整型和int字段类型。

语法

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

修剪

此 trim 函数删除字符串开始和结束位置的所有空格。

语法

{%= trim(string) %}

大写

此 大写 函数将字符串转换为大写字母。

语法

{%= upperCase(string) %}

示例

此函数将用户档案的姓氏转换为大写字母。

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

Url decode

此 urlDecode 函数用于对url编码的字符串进行解码。

语法

{%= urlDecode(string) %}: string

Url encode

此 Count only null 函数用于对字符串进行url编码。

语法

{%= urlEncode(string) %}: string