0.前言

TinyXML-2 是一个简单，小型，高效的 C ++ XML 解析器，可以轻松集成到其他程序中，直接引用源文件的话只需要包含两个文件（h 和 cpp，此外还有个测试文件里面带有 demo）。

TinyXML-2 解析 XML 文档，并以此为基础构建可读取，修改和保存的文档对象模型（DOM）。文档说，在解释 XML 时仅使用 UTF-8 ，假定所有 XML 为 UTF-8 （看了下使用 MSVC 编译器时生成的 XML 文件文本编码使用的本地编码）。该库还支持打印到文件或内存，使用 XMLPrinter 类。

GitHub 链接：https://github.com/leethomason/tinyxml2

（在线文档我的网访问不了，但是下载库 GitHub 上的项目后带有离线文档，用谷歌浏览器在线翻译即可）

1.基本使用

引入头文件：

#include "tinyxml2.h"

//tinyxml2的类在tinyxml2命名空间
using namespace tinyxml2;

使用 XMLDocument 加载和保存 XML 文件：

//构造一个xml文档类
XMLDocument doc;
//读取文件
//从磁盘加载XML文件。成功返回XML_SUCCESS（0），或者返回errorID。
XMLError error = doc.LoadFile(xmlPath);
//也可以解析字符串
//XMLError tinyxml2::XMLDocument::Parse(const char *xml,size_t nBytes = static_cast<size_t>(-1));
if (error != XMLError::XML_SUCCESS)
	return;
//存储到文件，参数2 compact紧凑默认false
doc.SaveFile(xmlPath);

可以借助 XMLDocument 生成节点（元素、属性、文本、注释等），也可以直接 new 生成对象，但还要使用 Insert 方法才能插入到结构中：

//元素
XMLElement * tinyxml2::XMLDocument::NewElement (const char *name)
//注释
XMLComment * tinyxml2::XMLDocument::NewComment (const char *comment)
//文本
XMLText * tinyxml2::XMLDocument::NewText (const char *text) 
//XML文件头描述
XMLDeclaration * tinyxml2::XMLDocument::NewDeclaration (const char *text=0)
//未知类型
XMLUnknown * tinyxml2::XMLDocument::NewUnknown (const char *text)

//插入到末尾
XMLNode * tinyxml2::XMLNode::InsertEndChild (XMLNode *addThis)
//插入到开头
XMLNode * tinyxml2::XMLNode::InsertFirstChild (XMLNode *addThis)
//插入到节点的下一个位置
XMLNode * tinyxml2::XMLNode::InsertAfterChild (XMLNode *afterThis, XMLNode *addThis)

删除子节点：

//删除所有子节点
void tinyxml2::XMLNode::DeleteChildren ()
//删除指定子节点
void tinyxml2::XMLNode::DeleteChild (XMLNode *node)

对于查找，可通过父子兄弟节点进行遍历：

//是否不包含子节点
bool tinyxml2::XMLNode::NoChildren () const
//第一个子节点
const XMLNode * tinyxml2::XMLNode::FirstChild () const
//第一个子元素 
const XMLElement * tinyxml2::XMLNode::FirstChildElement (const char *name=0) const
//最后一个子节点
const XMLNode * tinyxml2::XMLNode::LastChild () const
//最后一个子元素
const XMLElement * tinyxml2::XMLNode::LastChildElement (const char *name=0) const
//上一个兄弟节点 
const XMLNode * tinyxml2::XMLNode::PreviousSibling () const
//上一个兄弟元素 
const XMLElement * tinyxml2::XMLNode::PreviousSiblingElement (const char *name=0) const
//下一个兄弟节点
const XMLNode * tinyxml2::XMLNode::NextSibling () const
//下一个兄弟元素
const XMLElement * tinyxml2::XMLNode::NextSiblingElement (const char *name=0) const

如果要遍历整个文档，可从 XMLDocument 开始遍历，XXXChild + XXXSibling 遍历所有的子节点和兄弟节点。

2.简单的示例

第一生成的 XML 结构如下：

<?xml version="1.0" encoding="UTF-8"?>
<ElementA Level="A" Value="1992">ElementA text<!--ElementA comment--><ElementB Level="B">ElementB text<!--ElementB comment--></ElementB>
</ElementA>

<!--My TinyXml2 Test... ...-->Some Test
<!Unknown>

第二次生成的 XML 结构如下：

<?xml version="1.0" encoding="UTF-8"?>
<Root>
    <GroupA Type="A">
        <Name>中文<Content>111111</Content>
        </Name>
        <Name>English<Content>222222</Content>
        </Name>
        <Name>123<Content>333333</Content>
        </Name>
    </GroupA>
    <GroupB Type="B"/>
    <GroupC Type="C"/>
</Root>

完整代码：

#include <iostream>
#include <string>

#include "tinyxml2.h"

//tinyxml2的类在tinyxml2命名空间
using namespace tinyxml2;

//测试生成xml
void create_xml(const char* xmlPath);
//测试解析xml
void parse_xml(const char* xmlPath);
//遍历xml node
void traversal_node(XMLNode* node);
//遍历xml element
void traversal_element(XMLNode* node, int level);
//生成预定格式xml
void create_xml2(const char* xmlPath);
//解析预定义格式xml
void parse_xml2(const char* xmlPath);

int main()
{
	const char* path = "./test.xml";
	create_xml(path);
	parse_xml(path);

	const char* path2 = "./test2.xml";
	create_xml2(path2);
	parse_xml2(path2);

	system("pause");
	return 0;
}

void create_xml(const char* xmlPath)
{
	std::cout << "\ncreate_xml:" << xmlPath << std::endl;
	//【】构造一个xml文档类
	XMLDocument doc;
	//【】操作文档相关接口
	//创建与此文档关联的新声明。对象的内存由文档管理。
	//如果'text'参数为null，则使用标准声明:
	//<?xml version="1.0" encoding="UTF-8"?>
	XMLDeclaration* declaration = doc.NewDeclaration();
	//创建与此文档关联的新元素。元素的内存由文档管理。
	XMLElement* element = doc.NewElement("ElementA");
	//创建与此文档关联的新注释。注释的内存由文档管理。
	XMLComment* comment = doc.NewComment("My TinyXml2 Test... ...");
	//创建与此文档关联的新文本。文本的存储由文档管理。
	XMLText* text = doc.NewText("Some Test");
	//创建与此文档关联的新的未知节点。对象的内存由文档管理。
	XMLUnknown* unknown = doc.NewUnknown("Unknown");
	//【】创建了节点还要插入文档中
	//添加一个子节点作为最后一个（右）子节点。如果子节点已经是文档的一部分，则将其从其旧位置移至新位置。
	//XMLNode* tinyxml2::XMLNode::InsertEndChild(XMLNode * addThis);
	//添加一个子节点作为第一个（左）子节点。如果子节点已经是文档的一部分，则将其从其旧位置移至新位置。
	//XMLNode* tinyxml2::XMLNode::InsertFirstChild(XMLNode* addThis);
	//在指定的子节点之后添加一个节点。如果子节点已经是文档的一部分，则将其从其旧位置移至新位置。
	//XMLNode* tinyxml2::XMLNode::InsertAfterChild(XMLNode * afterThis, XMLNode * addThis);
	doc.InsertFirstChild(declaration);
	doc.InsertAfterChild(declaration, element);
	doc.InsertEndChild(comment);
	doc.InsertEndChild(text);
	doc.InsertEndChild(unknown);

	//【】操作节点相关接口
	//将命名属性设置为对应类型的value
	element->SetAttribute("Level", "A");
	element->SetAttribute("Value", 1992);
	//设置文本
	element->SetText("ElementA text");
	//注释
	element->InsertNewComment("ElementA comment");
	//添加子节点，接口已经带insert功能了
	XMLElement* sub_element = element->InsertNewChildElement("ElementB");
	sub_element->SetAttribute("Level", "B");
	sub_element->SetText("ElementB text");
	sub_element->InsertNewComment("ElementB comment");


	//【】存储到文件，参数2 compact紧凑默认false
	//结构写的不规范，感觉应该拿一个根节点把那些注释，文本包起来
	//不然解析的时候没法访问啊
	doc.SaveFile(xmlPath);
}

void parse_xml(const char* xmlPath)
{
	std::cout << "\nparse_xml:" << xmlPath << std::endl;
	//【】构造一个xml文档类
	XMLDocument doc;
	//【】读取文件
	//从磁盘加载XML文件。成功返回XML_SUCCESS（0），或者返回errorID。
	XMLError error = doc.LoadFile(xmlPath);
	//也可以解析字符串
	//从字符串解析XML文件。成功返回XML_SUCCESS（0），或者返回errorID。
	//XMLError tinyxml2::XMLDocument::Parse(const char *xml,size_t nBytes = static_cast<size_t>(-1));
	if (error != XMLError::XML_SUCCESS)
		return;
	//注意，实际解析时返回的指针记得判空，不然遇到解析失败异常就遭了

	//【】解析根元素
	//返回DOM的根元素。等效于FirstChildElement。要获取第一个节点，请使用FirstChild。
	XMLElement* root = doc.RootElement();
	std::cout << "RootElement name:" << root->Name() << std::endl;
	//获取第一个子元素，或者选择具有指定名称的第一个子元素。
	XMLElement* first = doc.FirstChildElement("ElementA");
	//给定一个属性名称，Attribute返回该名称的属性的值；如果不存在，则返回null。
	std::cout << "FirstChildElement Attr Level:" << first->Attribute("Level") << std::endl;
	std::cout << "FirstChildElement Attr Value:" << first->Attribute("Value") << std::endl;
	//如果'this'的第一个Child是XMLText，则GetText返回Text节点的字符串，否则返回null。
	std::cout << "FirstChildElement Text:" << first->GetText() << std::endl;

	//【】解析子元素
	XMLElement* sub = root->FirstChildElement("ElementB");
	std::cout << "SubElement Attr Level:" << sub->Attribute("Level") << std::endl;
	std::cout << "SubElement Text:" << sub->GetText() << std::endl;

	//【】
	//可使用FirstChild+NextSibling遍历子节点
	std::cout << "\ntraversal_xml:" << std::endl;
	traversal_node(&doc);
	//或者FirstChildElement+NextSiblingElement遍历子元素
	std::cout << "\ntraversal_element:" << std::endl;
	traversal_element(&doc, 0);
}

void traversal_node(XMLNode* node)
{
	if (!node)
		return;
	for (XMLNode* current = node->FirstChild(); current != nullptr; current = current->NextSibling())
	{
		XMLNode* temp = current;
		if (temp->Value() != nullptr)
			std::cout << temp->Value() << std::endl;
		if (!temp->NoChildren())
			traversal_node(temp);
	}
}

void traversal_element(XMLNode* node, int level)
{
	if (!node)
		return;
	for (XMLElement* current = node->FirstChildElement(); current != nullptr; current = current->NextSiblingElement())
	{
		XMLElement* temp = current;
		//这里我使用点号来表示层级缩进
		std::cout << std::string(level * 5, '.') << temp->Name() << std::endl;
		if (temp->GetText() != nullptr)
			std::cout << std::string(level * 5, '.') << "> Text" << ":" << temp->GetText() << std::endl;
		const XMLAttribute* attr = temp->FirstAttribute();
		if (attr != nullptr)
			std::cout << std::string(level * 5, '.') << "> Attr" << ":" << attr->Value() << std::endl;
		if (temp->FirstChildElement() != nullptr)
			traversal_element(temp, level + 1);
	}
}

void create_xml2(const char* xmlPath)
{
	std::cout << "\ncreate_xml2:" << xmlPath << std::endl;
	//【】构造一个xml文档类
	XMLDocument doc;

	//【】构建我们的xml数据结构
	XMLDeclaration* declaration = doc.NewDeclaration();
	doc.InsertFirstChild(declaration);
	//创建与此文档关联的新元素。元素的内存由文档管理。
	XMLElement* root = doc.NewElement("Root");
	doc.InsertEndChild(root);
	//子节点
	XMLElement* group_a = root->InsertNewChildElement("GroupA");
	group_a->SetAttribute("Type", "A");
	XMLElement* a_1 = group_a->InsertNewChildElement("Name");
	a_1->SetText("中文");
	XMLElement* a_1_sub = a_1->InsertNewChildElement("Content");
	a_1_sub->SetText("111111");
	XMLElement* a_2 = group_a->InsertNewChildElement("Name");
	a_2->SetText("English");
	XMLElement* a_2_sub = a_2->InsertNewChildElement("Content");
	a_2_sub->SetText("222222");
	XMLElement* a_3 = group_a->InsertNewChildElement("Name");
	a_3->SetText("123");
	XMLElement* a_3_sub = a_3->InsertNewChildElement("Content");
	a_3_sub->SetText("333333");
	XMLElement* group_b = root->InsertNewChildElement("GroupB");
	group_b->SetAttribute("Type", "B");
	XMLElement* group_c = root->InsertNewChildElement("GroupC");
	group_c->SetAttribute("Type", "C");


	//【】存储到文件，参数2 compact紧凑默认false
	doc.SaveFile(xmlPath);
}

void parse_xml2(const char* xmlPath)
{
	std::cout << "\nparse_xml2:" << xmlPath << std::endl;
	//【】构造一个xml文档类
	XMLDocument doc;
	//【】读取文件
	//从磁盘加载XML文件。成功返回XML_SUCCESS（0），或者返回errorID。
	XMLError error = doc.LoadFile(xmlPath);
	//也可以解析字符串
	//从字符串解析XML文件。成功返回XML_SUCCESS（0），或者返回errorID。
	//XMLError tinyxml2::XMLDocument::Parse(const char *xml,size_t nBytes = static_cast<size_t>(-1));
	if (error != XMLError::XML_SUCCESS)
		return;
	//注意，实际解析时返回的指针记得判空，不然遇到解析失败异常就遭了

	//【】解析根节点
	//返回DOM的根元素。等效于FirstChildElement。要获取第一个节点，请使用FirstChild。
	XMLElement* root = doc.RootElement();
	//【】查找
	XMLElement* find_ele = root->FirstChildElement("GroupA");
	if (find_ele) {
		std::cout << find_ele->Name() << std::endl;
		const XMLAttribute* attr = find_ele->FindAttribute("Type");
		if (attr) {
			std::cout << attr->Name() << ":" << attr->Value() << std::endl;
		}
		XMLElement* find_sub = find_ele->FirstChildElement("Name");
		if (find_sub && find_sub->GetText()) {
			std::cout << find_sub->GetText() << std::endl;
		}
	}

	//【】遍历
	std::cout << "\ntraversal_element:" << std::endl;
	traversal_element(&doc, 0);
}