str_RegexReplace函数

函数名：wb_正则替换 / str_RegexReplace

函数功能

使用正则表达式模式，在文本中查找匹配内容并替换为指定文本，支持复杂文本替换操作。

参数规范

参数名	类型	必填	示例	特殊说明
input	String	是	"abc123xyz456"	原始待替换文本
pattern	String	是	"\d+"	正则表达式，用于匹配需替换的文本部分
replacement	String	是	"NUM"	替换为的文本

使用案例

3.1 替换所有数字为固定文本

问题描述：将文本中的所有数字替换成"NUM" 公式演示：

=str_RegexReplace("abc123xyz456", "\d+", "NUM")

输出效果：

abcNUMxyzNUM

3.2 替换邮箱域名

问题描述：替换邮箱中的域名部分 公式演示：

=str_RegexReplace("test@example.com", "@example\.com", "@domain.com")

输出效果：

test@domain.com

3.3 空文本输入返回空文本

问题描述：输入为空时直接返回空文本 公式演示：

=str_RegexReplace("", "\d+", "NUM")

输出效果：

(empty string)

技术说明

4.1 替换规则

• 使用.NET标准正则表达式进行查找替换
• replacement支持常规字符串替换，不支持复杂正则替换表达式的扩展（如回调）

4.2 异常处理

错误场景	返回值
空文本输入	返回空文本本身
正则异常或其它错误	返回 "错误: 异常信息" 字符串

扩展应用

6.1 敏感词替换

=str_RegexReplace(A1, "敏感词", "***")

6.2 去除所有空白字符

=str_RegexReplace(A1, "\s+", "")

注：本函数在WPS 2019+和Excel 365中测试通过