ReplaceRegEx - 脚本和图表函数
ReplaceRegEx() 在替换输入字符串和指定正则表达式模式之间的一个或多个匹配后,返回一个字符串。取代匹配文本的文本在 to_str 参数中指定。函数从左到右运行,但如果指定一个负 occurrence 值,函数将从右到左读取。
该函数执行大小写敏感的正则表达式操作。您也可以用变种 ReplaceRegExI() 来作为替代,执行不区分大小写的正则表达式操作。
语法:
ReplaceRegEx (text, regex, to_str [, occurrence])
返回数据类型: 字符串
参数 | 描述 |
---|---|
text | 输入字符串文本,您希望用 to_str 中的新文本全部或部分替换该文本。 |
regex | 定义何时替换文本的正则表达式。该参数与 text 参数之间的匹配将被替换。 |
to_str | 您要用来替换 text 中现有内容的新文本。 |
occurrence |
要替换为新文本的匹配项(输入文本与正则表达式之间)的编号。 这是可选参数。如果省略,默认值为 0。当使用值为 0 或省略参数时,text 和 regex 之间的所有匹配结果都会被替换为 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),使其不会显示给分析您应用程序的用户。