C++如何解析YAML中的空映射节点_Node::size判断用法【基础】-C++-PHP中文网

空映射节点的 size() 返回 0 前必须依次验证 isdefined() 和 ismap()，否则调用 size() 可能崩溃；对 sequence 调用 size() 返回元素个数，语义不同但同样需先校验类型。

c++如何解析yaml中的空映射节点_node::size判断用法【基础】

空映射节点（如 {} 或 foo: {}）的 Node::size() 返回 0，但前提是必须先确认它是合法的 Map 类型，否则调用 size() 会触发未定义行为甚至崩溃。

为什么 `node.size()` 不能直接用

size() 不是“安全探针”，它只对 IsMap() 或 IsSequence() 为 true 的节点有意义。如果节点是 Scalar、Null，或根本未定义（!node.IsDefined()），调用 size() 可能立即段错误或返回垃圾值。

常见错误现象：config["database"].size() 崩溃，其实是因为 config["database"] 根本没在 YAML 中定义，IsDefined() 为 false
YAML 中写 cache: {} → 对应的 node 是合法 Map，IsMap() == true，size() == 0
YAML 中写 cache:（冒号后无内容且无缩进）→ 实际解析为 Null 节点，IsMap() == false，此时调用 size() 危险

正确判断空映射的三步顺序

必须严格按顺序检查，跳过任意一步都可能出错：

先调用 node.IsDefined()：排除文件缺失键、拼写错误、加载失败等上游问题
再调用 node.IsMap()：确认它是映射结构，不是标量或序列
最后调用 node.size() == 0：此时 size() 才有明确定义，返回 0 表示空映射

示例代码片段：

Zenlink - Node SDK for ZenHeart

ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。

下载

YAML::Node config = YAML::LoadFile("config.yml");
if (!config["cache"].IsDefined()) {
    throw std::runtime_error("missing 'cache' section");
}
if (!config["cache"].IsMap()) {
    throw std::runtime_error("'cache' must be a mapping, not scalar or sequence");
}
if (config["cache"].size() == 0) {
    // 确认为 {}
}

`size()` 在 Sequence 上的行为差异

别被名字误导：size() 对 Sequence 也有效，但它返回的是元素个数（即 YAML 中 - item1 这样的条目数），而对 Map 返回的是键值对数量。两者语义不同，但都要求先做类型校验。

错误用法：if (node.size() > 0) —— 没判类型，不知道是在查 Map 还是 Sequence
正确写法：if (node.IsSequence() && node.size() > 0) 或 if (node.IsMap() && node.size() == 0)
注意：node[i] 访问 Sequence 时，i 必须 ，越界不会自动返回空节点，而是抛 <code>std::runtime_error