str_Concat函数

函数名：wb_文本连接 / str_Concat

函数功能

智能连接多个文本或数组元素，支持动态分隔符和混合数据类型处理，自动跳过空值并保持原始数据顺序。

参数规范

参数名	类型	必填	示例	特殊说明
分隔符	String	是	","	支持多字符分隔符如"→"
文本1	Variant	是	A1	可接受单元格/数组/常量
...	Variant	否	B2:B5	可变参数支持无限扩展

使用案例

基础文本连接

问题描述：合并姓名与职称
公式演示：

=str_Concat(" - ", "张三", "高级工程师")

输出效果：

张三 - 高级工程师

区域数据合并

问题描述：合并A列所有非空单元格
公式演示：

=str_Concat("、", A1:A10)

输出效果（当A1:A3含"北京","上海","广州"）：

北京、上海、广州

技术说明

数据处理规则

• 自动转换：数值/日期隐式转为文本
• 空值处理：跳过ExcelEmpty及null值
• 数组展开：自动展开多维数组为一维序列

异常处理

错误场景	返回值
缺少分隔符	#N/A
所有参数为空	空字符串

扩展应用

构建SQL语句

=str_Concat(", ", "SELECT * FROM users WHERE id IN (", str_Concat("','", D2:D9), ")")

生成CSV文件

=str_Concat(CHAR(10), "姓名,年龄", str_Concat(",", A2:B10))

输出示例：

姓名,年龄
张三,30
李四,25

注：本函数在WPS 2023+和Excel 2016中测试通过