类对象支持库(不是扁平命令)。路径:支持库 → 扩展类库 → TOML类。
旁路插件:plugins/supportlib.toml/(feature_id = supportlib.toml)。API 与 JSON类 / YAML类 对齐,路径语法相同。
类型名必须写完整「TOML类」。声明时自动创建;默认根为空对象(table)。
硬约束
- 类型名必须写「TOML类」。
- 到文本() / 保存() 要求根为对象(TOML 文档根必须是 table)。内存中可
置为空数组,但序列化会失败并写入 取错误()。 - TOML 无 null:
置空在内存中为 null,序列化时写成空字符串。 - 方法调用必须带括号。
- 旁路 JSON codegen 不支持「另一同类对象」作参数,故合并用
合并文本。
快速开始
TOML类 t
如果 (t.解析("a = 1\nb = true")) {
输出(t.取整数("a"))
输出(t.取逻辑("b"))
输出(t.取类型("a"))
}
t.置为空对象()
t.置文本("name", "demo")
输出(t.到文本(真))
t.保存("out.toml", 真)
TOML类 副本 = t.克隆()
副本.合并文本("extra = 2", 真)
TOML类/方法
共 24 条(方法名与 YAML类 相同):
解析 · 加载 · 保存 · 到文本 · 取错误 · 清空 · 置为空对象 · 置为空数组 · 克隆 · 取文本 · 取整数 · 取小数 · 取逻辑 · 取类型 · 是否存在 · 取成员数 · 取成员名 · 置文本 · 置整数 · 置小数 · 置逻辑 · 置空 · 删除 · 合并文本
路径语法:点号字段 + 下标,如 "user.name"、"items[0].id";空路径表示根。
深合并规则与 YAML类 相同:对象递归;数组覆盖则替换否则追加;标量仅在 覆盖=真 时替换。
易错对照
| 错误 | 正确 |
|---|---|
| 类型写成 TOML | 必须「TOML类」 |
| 根为数组后调到文本/保存 | 根须为对象;先置为空对象再写字段 |
| 想两对象互并 | 用 合并文本(源.到文本()) |