TinyXML2 轻量级 XML 解析库全面解析-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00990/article/details/148505659

TinyXML2 轻量级 XML 解析库全面解析

tinyxml2 TinyXML2 is a simple, small, efficient, C++ XML parser that can be easily integrated into other programs. 项目地址: https://gitcode.com/gh_mirrors/ti/tinyxml2

项目概述

TinyXML2 是一个轻量级、高效的 C++ XML 解析库，它能够轻松集成到各种项目中。作为 TinyXML 的升级版本，TinyXML2 在内存使用和性能方面都有显著提升，特别适合游戏开发等对性能要求较高的场景。

核心功能

XML 文档解析与构建

TinyXML2 能够解析 XML 文档并构建文档对象模型(DOM)，开发者可以：

读取和修改 DOM 结构
将修改后的文档保存到文件或输出流
直接从代码构建 XML 文档而不需要先解析文件
以流式方式生成 XML 内容

基本特性

单文件实现：仅包含一个头文件和一个源文件，集成简单
无依赖：不依赖 STL、RTTI 或异常处理
内存高效：相比 TinyXML-1 显著减少了内存分配
UTF-8 支持：完全支持 UTF-8 编码
错误定位：提供精确的行号错误报告

技术细节解析

内存管理模型

TinyXML2 采用独特的内存管理方式：

XMLDocument doc;  // 可以在栈上或堆上创建
XMLElement* elem = doc.NewElement("Element");  // 子节点必须由文档对象创建

所有节点(XMLElement、XMLText 等)都由 XMLDocument 拥有，文档销毁时会自动清理所有子节点。

空白字符处理

TinyXML2 提供三种空白处理模式：

PRESERVE_WHITESPACE(默认)：
- 保留文本节点内的空白
- 规范化换行符为 LF
- 不保留元素间的空白
COLLAPSE_WHITESPACE：
- 移除首尾空白
- 将换行符转换为空格
- 合并连续空格为单个空格
PEDANTIC_WHITESPACE：
- 保留所有空白，包括元素间的空白

实体处理

支持预定义实体和数字字符引用：

<!-- 预定义实体 -->
&lt; &gt; &amp; &quot; &apos;

<!-- 数字字符引用 -->
&#xA0;  &#160;  <!-- 都表示不换行空格 -->

使用示例

基本用法

// 加载和解析XML文件
XMLDocument doc;
doc.LoadFile("config.xml");

// 获取根元素
XMLElement* root = doc.FirstChildElement("Config");

// 读取属性值
const char* value = root->FirstChildElement("Setting")->Attribute("name");

创建XML文档

XMLDocument doc;

// 创建声明
XMLDeclaration* decl = doc.NewDeclaration();
doc.InsertFirstChild(decl);

// 创建根元素
XMLElement* root = doc.NewElement("Root");
doc.InsertEndChild(root);

// 添加子元素
XMLElement* element = doc.NewElement("Item");
element->SetAttribute("id", "1");
root->InsertEndChild(element);

// 保存文件
doc.SaveFile("output.xml");

流式输出

XMLPrinter printer;
printer.OpenElement("Root");
printer.PushAttribute("version", "1.0");
printer.OpenElement("Items");
printer.CloseElement();
printer.CloseElement();

// 获取生成的XML字符串
const char* xmlStr = printer.CStr();