跳到主要内容 跳到补充内容

ReplaceRegEx - 脚本和图表函数

ReplaceRegEx() 在替换输入字符串和指定正则表达式模式之间的一个或多个匹配后,返回一个字符串。取代匹配文本的文本在 to_str 参数中指定。函数从左到右运行,但如果指定一个负 occurrence 值,函数将从右到左读取。

该函数执行大小写敏感的正则表达式操作。您也可以用变种 ReplaceRegExI() 来作为替代,执行不区分大小写的正则表达式操作。

语法:  

ReplaceRegEx (text, regex, to_str [, occurrence])

返回数据类型: 字符串

参数
参数 描述
text 输入字符串文本,您希望用 to_str 中的新文本全部或部分替换该文本。
regex 定义何时替换文本的正则表达式。该参数与 text 参数之间的匹配将被替换。
to_str 您要用来替换 text 中现有内容的新文本。
occurrence

要替换为新文本的匹配项(输入文本与正则表达式之间)的编号。

这是可选参数。如果省略,默认值为 0。当使用值为 0 或省略参数时,textregex 之间的所有匹配结果都会被替换为 to_str

如果要从右向左识别匹配项,可以指定一个 occurrence 负值。

函数示例
示例 结果
ReplaceRegEx('abc123','[0-9]','x') 返回 abcxxx。在此示例中,输入字符串中与正则表达式模式匹配的所有文本都会被新文本替换。
ReplaceRegEx('abc123','[0-9]','x',1) 返回 abcx23。只替换输入字符串和正则表达式模式之间首次出现的匹配项。
ReplaceRegEx('abc123','[0-9]','x',4) 返回 abc123。输入字符串和正则表达式模式之间只有三种可能的匹配,因此不会进行修改。
ReplaceRegEx('ABC123','[a-c]','5') 返回 ABC123。由于 ReplaceRegEx() 区分大小写,不使用区分大小写的变体,因此不进行修改。
ReplaceRegExI('ABC123','[a-c]','5') 返回 555123。使用不区分大小写的函数变体,ReplaceRegExI()

适用场景

您可以使用 ReplaceRegEx() 对文本进行修改,以符合格式样式和合规标准,尤其是当数据中存在复杂样式时。例如,您可以重新格式化电话号码字符串,使其只包含数值。

如有需要,您还可以使用此函数屏蔽敏感信息,如个人身份信息 (PII),使其不会显示给分析您应用程序的用户。

例 1 - 更新员工电子邮件地址的加载脚本

例 2 - 加载脚本以格式化 ISBN 编码

例 3 - 更新二级电子邮件地址的图表表达式

本页面有帮助吗?

如果您发现此页面或其内容有任何问题 – 打字错误、遗漏步骤或技术错误 – 请告诉我们如何改进!