文本合并数组

⚠️ 此函数已废弃：此函数在当前版本源代码中不再存在，请使用 wb_文本连接 / str_Concat 替代。

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

功能描述

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

会员等级：🟢 免费版（Free）

语法

=str_JoinArray(分隔符, 数组)

参数

参数名	类型	必填	默认值	说明
分隔符	String	是	无	用于连接数组元素的分隔符
数组	Object[]	是	无	需要合并的文本数组

返回值

String - 数组元素用分隔符连接后的字符串。

使用示例

使用逗号合并数组

公式：

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

结果：

a,b,c

替代方案（推荐）

公式：

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

结果：

a,b,c

技术说明

• 原实现使用 .NET 的 string.Join 方法合并数组元素
• 对数组中的 null 元素转换为空字符串后参与连接
• 输入数组为空时返回空字符串

错误处理

错误场景	返回值
函数已废弃，不可调用	#NAME?
输入数组为空	空字符串 ""（原实现行为）
运行异常	"错误: {异常信息}"（原实现行为）