str_JoinArray函数

函数名：wb_文本合并数组 / str_JoinArray

函数功能

将数组中的文本元素合并为一个字符串，元素间以指定的分隔符连接，支持空元素自动转换为空字符串。

参数规范

参数名	类型	必填	示例	特殊说明
delimiter	String	是	","	用于连接数组元素的分隔符
array	Object[]	是	{"a", "b", "c"}	需要合并的文本数组

使用案例

3.1 使用逗号合并数组

问题描述：将数组元素用逗号连接成字符串 公式演示：

=str_JoinArray(",", {"a","b","c"})

输出效果：

a,b,c

3.2 合并含空元素的数组

问题描述：数组中含空元素，合并时空元素转为空字符串 公式演示：

=str_JoinArray("-", {"a", "", "c"})

输出效果：

a--c

3.3 空数组返回空字符串

问题描述：数组为空时返回空字符串 公式演示：

=str_JoinArray(",", {})

输出效果：

（空字符串）

技术说明

4.1 合并实现

• 使用.NET的string.Join方法合并数组元素
• 对数组中的null元素转换为空字符串

4.2 异常处理

错误场景	返回值
输入数组为空	返回空字符串
运行异常	返回错误信息文本，如"错误: 异常描述"

扩展应用

6.1 组合单元格内容

=str_JoinArray(" ", A1:A3)  // 合并A1到A3单元格内容，中间以空格分隔

6.2 生成CSV格式字符串

=str_JoinArray(",", {"张三","30","男"})

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