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会更直接。 - 转换后得到的是数组结构,不等同于普通对象字段集合。
