字符串函数 string-functions

concat(<string>,<string>)

concat(<listString>)

返回字符串。

concat("Hello","World")

返回“HelloWorld”。

concat(["Hello"," ","World"])

返回“Hello World”。

• 字符串

contain(<string>,<string>)

返回布尔值。

contain("rowing is great", "great")

返回真。

containIgnoreCase(<string>,<string>)

返回布尔值。

containIgnoreCase("rowing is great", "GREAT")

返回真。

endWith(<string>,<string>)

返回布尔值。

endWith("Hello World", "World")

返回真。

endWith("Hello World", "Hello")

返回假。

endWithIgnoreCase(<string>,<string>)

返回布尔值。

endWithIgnoreCase("rowing is great", "AT")

返回真。

• 字符串

equalIgnoreCase(<string>,<string>)

返回布尔值。

equalIgnoreCase("rowing is great", "rowing is GREAT")

返回真。

indexOf(<string>,<string>)

返回整数。

indexOf("Hello", "l")

返回2。

说明：

在“Hello”中，“l”的第一个实例位于位置2。

• 字符串

isEmpty(<string>)

返回布尔值。

isEmpty("")

返回真。

isEmpty("Hello World")

返回假。

isEmpty(<null>)

返回假。

• 字符串

isNotEmpty(<string>)

返回布尔值。

isNotEmpty("")

返回假。

isNotEmpty("hello")

返回真。

lastIndexOf(<string>,<string>)

返回整数。

lastIndexOf("Hello", "l")

返回3。

说明：

在“Hello”中，“l”的最后一次出现在位置3。

• 字符串

length(<string>)

返回整数。

length("Hello World")

返回11。

• 字符串

lower(<string>)

返回字符串。

lower("A")

返回“a”。

matchRegExp(<string>,<string>)

返回布尔值。

matchRegExp("12345", "\\d+")

返回真。

• 字符串

notEqualIgnoreCase(<string>,<string>)

返回布尔值。

replace(<base>,<target>,<replacement>)

返回字符串。

replace("Hello World", "l", "x")

返回“Hexlo World”。

RegExp示例：

由于target参数是RegExp，因此根据要替换的字符串，您可能需要转义某些字符。 示例如下：

• 要计算的字符串：|OFFER_A|OFFER_B
• 由配置文件属性#{ExperiencePlatform.myFieldGroup.profile.myOffers}提供
• 要替换的字符串： |OFFER_A
• 字符串替换为： ''
• 您需要在|字符之前添加\\。

表达式为：

replace(#{ExperiencePlatform.myFieldGroup.profile.myOffers}, '\\|OFFER_A', '')

返回的字符串是： |OFFER_B

您还可以构建要替换给定属性的字符串：

replace(#{ExperiencePlatform.myFieldGroup.profile.myOffers}, '\\|' + #{ExperiencePlatform.myFieldGroup.profile.myOfferCode}, '')

replaceAll(<baseString>,<sourceString>,<replacementString>)

返回字符串。

replaceAll("Hello World", "l", "x")

返回“Hexxo Worxd”。

由于target参数是RegExp，因此根据要替换的字符串，您可能需要转义某些字符。 请参阅replace函数中的示例。

split(<input string>, <separator string>)

返回listString。

split("A_B_C", "_")

返回["A","B","C"]

具有事件字段“event.appVersion”且值为“20.45.2.3434”的示例

split(@event{event.appVersion}, "\\.")

返回["20", "45", "2", "3434"]

startWith(<string>,<string>)

返回布尔值。

startWith("Hello World", "Hello")

返回真。

startWith("Hello World", "World")

返回假。

startWithIgnoreCase(<string>,<string>)

返回布尔值。

startWithIgnoreCase("rowing is great", "RO")

返回真。

substr(<string>,<beginIndex>)

substr(<string>,<beginIndex>,<endIndex>)

返回字符串。

substr("Hello World",6)

返回“World”。

substr("Hello World", 0, 5)

返回“Hello”。

trim(<string>)

返回字符串。

trim(" Hello ")

返回“Hello”。

upper(<string>)

返回字符串。

upper("b")

返回“B”。

uuid()

返回字符串。

uuid()

返回“79e70b7f-8a85-400b-97a1-9f9826121553”。

本节包含结构化知识，用于支持与本主题相关的解释、检索和问答。

要全面了解相关信息，应将此信息与本页上的文档相结合。 这两个源都不是独立的；页面描述了功能，而本节提供了其他上下文来帮助消除术语、意图、适用性和约束条件的歧义。

• TL；DR：​本页记录了AJO历程表达式中可用的所有字符串函数，包括文本搜索、比较、转换、提取、验证、替换、拆分和唯一标识符生成。

意图：

• 使用concat连接两个或多个字符串
• 使用contain或containIgnoreCase搜索字符串中的子字符串（区分大小写）
• 比较两个字符串，忽略使用equalIgnoreCase或notEqualIgnoreCase的大小写
• 使用startWith、endWith及其不区分大小写的变量检查字符串是否以特定前缀或后缀开头或结尾
• 使用substr按索引位置提取子字符串
• 使用replace或replaceAll替换字符串中模式的第一次或所有匹配项
• 使用split按分隔符将字符串拆分为令牌列表
• 使用uuid生成用于唯一标识符需求的随机UUID
• 使用isEmpty或isNotEmpty检查字符串是否为空或非空

术语表：

• 正则表达式模式：在replace、replaceAll和matchRegExp中用作目标参数的正则表达式模式 — 特殊字符必须使用\\进行转义
• UUID：通用唯一标识符 — 由uuid()返回的随机生成的字符串标识符
• substr：通过指定开始索引和可选结束索引（从零开始）来提取字符串的一部分

护栏：

• replace和replaceAll中的target参数被视为RegExp；特殊字符（如|、.）必须使用\\进行转义
• replace仅替换第一个匹配的匹配匹配项；使用replaceAll替换每个匹配项
• isEmpty为null值返回false （不是true）；null不被视为空字符串
• 未找到匹配项时，indexOf和lastIndexOf返回–1
• 字符串索引位置从零开始（第一个字符位于位置0）

术语：

• 规范名称：字符串函数 — 首字母缩略词：none — 变体：文本函数，字符串处理函数
• 同义词： “contain” = “substring check”； “split” = “tokenize string”； “trim” = “strip whitespace”
• 请勿混淆：“replace”（仅第一次发生次数）≠“replaceAll”（所有发生次数）
• 请勿混淆：“indexOf”（第一个发生位置）≠“lastIndexOf”（最后一个发生位置）
• 请勿混淆：“isEmpty”（仅对零长度字符串为true）≠null检查（对null，isEmpty返回false）
• 请勿混淆：“equalIgnoreCase”（在相等忽略大小写时返回true）≠“notEqualIgnoreCase”（在忽略大小写不同时返回true）

常见问题解答：

• 问：如何检查字符串是否包含子字符串（不考虑大小写）？ — 使用containIgnoreCase("myString", "searchTerm")，如果在任何情况下都找到搜索项，则返回true。
• 问：replace与replaceAll之间有何区别？ — replace仅替换第一个匹配匹配匹配匹配项；replaceAll替换字符串中的每个匹配项。
• 问：为什么我需要对replace中的|字符进行转义？ — 目标参数被视为正则表达式；|是一个特殊的RegExp字符，必须作为\\|转义才能被视为文本管道。
• 问：isEmpty是否为null返回true？ — 否，isEmpty为null返回false；它只为零长度字符串""返回true。
• 问：如何从版本字符串（如“20.45.2.3434”）中提取主版本号？ — 使用getListItem(split(@event{event.appVersion}, "\\."), 0)按点拆分并检索第一个元素。
• 问：如何在历程表达式中生成唯一标识符？ — 使用uuid()，这将返回随机生成的UUID字符串，而无需参数。