JSON

从 CSV 字符串初始化 JSON 数组

从一段 CSV 字符串初始化 JSON 数组,适用于把表格型文本快速转成可排序、可遍历的结构化数据。

命令用途

Json-InitArrayFromCsv 对应的实际命令写法是 JSON <标识> InitArrayFromCsv,用于把一段 CSV 字符串转换成 JSON 数组。

它适合把脚本里现成的 CSV 文本直接导入为数组结构,后续再做排序、导出或逐项读取。

命令名

Json-InitArrayFromCsv

调用格式

JSON <标识> InitArrayFromCsv <字符串>

参数说明

参数必填说明
标识是接收数组结果的 JSON 标识。
InitArrayFromCsv是固定子命令,表示从 CSV 字符串初始化数组。
字符串是要转换的 CSV 文本内容。

返回或影响

  • 该命令会把 CSV 字符串转换成 JSON 数组写入目标标识。
  • 适合处理表格型临时数据或从变量里拿到的 CSV 结果。
  • 初始化后,可继续配合排序、计数或导出命令处理。

示例

基础用法

#ACT
JSON csv数组 InitArrayFromCsv "name,score\n张三,100\n李四,90"

这段写法会把一段 CSV 字符串初始化到 csv数组 里,供后续继续处理。

常见变体

#ACT
JSON 奖励表 InitArrayFromCsv <$STR(S奖励CSV)>
JSON 奖励表 SortByName 0

这类写法适合先把变量中的 CSV 文本转成数组,再按名称做升序排序。

注意事项

  • CSV 字符串本身要保持合法格式,分隔符和换行都要与当前数据结构匹配。
  • 如果数据已经在文件里,不需要先读成字符串时,Json-InitArrayFromCsvFile 会更直接。
  • 转换后得到的是数组结构,不等同于普通对象字段集合。

相关命令