str_Replace函数

函数名：wb_文本替换 / str_Replace

函数功能

实现多分隔符批量替换功能，支持转义字符处理（如\n、\t、\|等）和大小写敏感选项，适用于复杂文本清洗场景。

参数规范

参数名	类型	必填	示例	特殊说明
input	String	是	`"A	B
oldValuePattern	String	是	`"||\n	\r\n"`
newValue	String	是	"-"	替换后的统一内容
caseSensitive	Boolean	否	TRUE	默认不区分大小写

使用案例

多分隔符替换

问题描述：同时替换文本中的竖线和换行符
公式演示：

=str_Replace("列A|列B\n列C", "\\||\\n", "→")

输出效果：

列A→列B→列C

转义字符处理

问题描述：替换实际文本中的\n字符
公式演示：

=str_Replace("换行\\n示例", "\\\\n", "<换行>", TRUE)

输出效果：

换行<换行>示例

技术说明

转义字符支持列表

转义符	实际字符	备注
|	`	`
\n	\n	换行符
\r\n	\r\n	回车换行
\t	\t	制表符

异常处理

错误场景	返回值
空分隔符	原样返回
无效转义序列	保留转义符

扩展应用

动态分隔符处理

=str_Replace(INDIRECT("B2"), ";"&CHAR(10), "|", FALSE)

混合使用函数生成分隔符

注：本函数在Office 365最新版本中支持所有转义符解析