c++如何解析XML c++ TinyXML2库使用教程【指南】

TinyXML2是C++中轻量易用的XML解析库,支持加载、遍历、读取属性/文本、数值转换及生成XML;使用时需检查错误码、注意空指针、循环遍历同名元素,并确保UTF-8编码。

用 C++ 解析 XML,TinyXML2 是最轻量、易上手的选择之一。它不依赖外部库,头文件即用,适合嵌入式、工具脚本或中小型项目。

一、快速开始:加载并读取 XML 文件

先确保已将 tinyxml2.htinyxml2.cpp 加入工程(或通过 vcpkg/conan 安装)。基本流程是:加载文档 → 查找根节点 → 遍历子元素。

  • XMLDocument::LoadFile() 读取本地 XML 文件,返回值为 XMLError,需检查是否成功(0 表示成功)
  • 调用 XMLDocument::RootElement() 获取根元素(XMLElement*),若为空说明文档结构异常或为空
  • 根节点本身也是 XMLElement,支持 FirstChildElement("TagName")NextSiblingElement("TagName") 等链式查找

二、提取元素内容与属性

XML 元素的内容(text)和属性(attribute)需分别获取,注意空指针安全。

  • 文本内容:调用 XMLElement::GetText(),返回 const char*;若元素含子节点(如混合内容),该函数返回 nullptr,此时应遍历 FirstChild() 并判断 XMLNode::ToText()
  • 属性值:用 XMLElement::Attribute("name") 直接获取 const char*;支持带默认值的重载 Attribute("name", &defaultValue)
  • 数值转换:TinyXML2 提供 QueryIntAttribute()QueryDoubleText() 等方法,失败时返回非零错误码,推荐配合 if 判断使用

三、遍历所有同名子元素

当存在多个相同标签(如 )时,避免只取第一个,应循环遍历。

  • 从根节点调用 FirstChildElement("item") 得到首个 item 元素
  • 后续用 element->NextSiblingElement("item") 向下迭代,直到返回 nullptr
  • 每轮循环中可重复调用 FirstChildElement() 访问其子项(如 ),无需递归函数也能清晰处理层级

四、写入 XML(生成/修改后保存)

TinyXML2 同样支持构建和输出 XML 文档,适合配置保存或数据导出。

  • 创建新文档:XMLDocument doc;,用 doc.NewElement("root") 创建节点,doc.NewText("value") 创建文本节点
  • 组装结构:用 parent->InsertEndChild(child) 添加子节点,支持链式调用(如 root->InsertEndChild(doc.NewElement("item"))->SetText("abc")
  • 保存文件:doc.SaveFile("output.xml"),返回 XMLError;也可用 doc.Printer() 获取字符串内容(需自行分配缓冲区或用 std::string 配合)

不复杂但容易忽略:中文路径或含中文文本时,确保源文件编码为 UTF-8(无 BOM),TinyXML2 默认按 UTF-8 解析,无需额外设置。