1 TinyXML2介绍
- TinyXML2是一个轻量级的、开源的C++库,专门用于解析和生成XML文档。它是原始TinyXML库的一个升级版本,设计得更为高效和强大,同时保持了简单易用的特点。TinyXML2非常适合那些需要处理XML数据,而又希望保持代码简洁和执行效率的应用场景。
2 相关API
-
2.1 加载文件
-
/* * @brief 加载XML文件 * @param [IN] filename 文件名 * @return 返回XML_SUCCESS表示成功,返回其他值表示失败 */ XMLError LoadFile(const char* filename);
-
-
2.2 获取XML数据的根节点
-
/* * @brief 获取XML数据的根节点 * @return 成功返回XML数据的根节点对象,失败返回NULL */ XMLElement* RootElement();
-
-
2.3 获取XML数据的指定节点
-
/* * @brief 获取XML数据的指定节点 * @param [IN] name 指定节点名称,不传或传0时获取根节点对象 * @return 成功返回XML数据的指定节点对象,失败返回NULL */ XMLElement* FirstChildElement(const char* name = 0);
-
-
2.4 获取某个XML节点的文本内容
-
/* * @brief 获取XML元素的文本内容 * @return 返回XML元素的文本内容 */ const char* GetText() const;
-
-
2.5 获取某个XMl节点的属性
-
/* * @brief 获取XML数据某个节点的属性 * @param [IN] name 属性名 * @return 返回某个节点属性值 */ const char* Attribute(const char* name) const;
-
-
2.6 将新创建的节点添加到指定父节点
-
/* * @brief 将新创建的节点添加到指定父节点 * @param [IN] addThis 要添加到父节点的对象 * @return c成功返回插入的节点自身,失败返回NULL */ XMLNode* InsertEndChild(XMLNode* addThis);
-
-
2.7 创建新的XMLElement对象
-
/* * @brief 创建新的XMLElement对象 * @param [IN] name 新元素的标签名称 * @return 成功返回指向新创建的XMLElement对象的指针, 失败返回NULL */ XMLElement* NewElement(const char* name);
-
-
2.8 设置某个XML节点的文本内容
-
/* * @brief 设置某个XML节点的文本内容 * @param [IN] inText 要设置的文本内容 */ void SetText(const char* inText);
-
-
2.9 保存XML数据到文件中
-
/* * @brief 保存XML数据到文件中 * @param [IN] filename 文件名 * @return 返回XML_SUCCESS表示成功,返回其他值表示失败 */ XMLError SaveFile(const char* filename);
-
3 演示
3.1 解析XML数据
- XML数据内容
-
<?xml version="1.0"?> <msg> <msg_id>1</msg_id> <header hattr="http"> <type>Post</type> <host>127.0.0.1</host> </header> <body battr="base64"> <data>aGVsbG8=</data> </body> </msg>
-
- 代码
-
#include <stdio.h> #include <iostream> #include <tinyxml2.h> int main(){ tinyxml2::XMLDocument xmlObj; // 解析数据 //const char* xmlData = "<msg></msg>"; //tinyxml2::XMLError errCode = xmlObj.Parse(xmlData); // 解析文件 tinyxml2::XMLError errCode = xmlObj.LoadFile("xmldata.txt"); if(errCode != tinyxml2::XML_SUCCESS){ printf("LoadFile xml failed, errCode = %d\n", errCode); return -1; } // 获取根节点 tinyxml2::XMLElement* root = xmlObj.RootElement(); if (!root) { std::cout << "Invalid document structure." << std::endl; return -1; } // msg_id tinyxml2::XMLElement* msgidElem = root->FirstChildElement("msg_id"); if(msgidElem != NULL){ const char* cMsgid = msgidElem->GetText(); printf("cMsgid: %s\n", cMsgid); } // 遍历header元素 for (tinyxml2::XMLElement* headerElem = root->FirstChildElement("header"); headerElem != nullptr; headerElem = headerElem->NextSiblingElement("header")) { // 获取属性 const char* cHattr = headerElem->Attribute("hattr"); printf("cHattr: %s\n", cHattr); // 获取字段值 tinyxml2::XMLElement* typeElem = headerElem->FirstChildElement("type"); if(typeElem != NULL){ const char* cType = typeElem->GetText(); printf("cType: %s\n", cType); } tinyxml2::XMLElement* hostElem = headerElem->FirstChildElement("host"); if(hostElem != NULL){ const char* cHost = hostElem->GetText(); printf("cHost: %s\n", cHost); } } // 遍历body元素 for (tinyxml2::XMLElement* bodyElem = root->FirstChildElement("body"); bodyElem != nullptr; bodyElem = bodyElem->NextSiblingElement("body")) { // 获取属性 const char* cBattr = bodyElem->Attribute("battr"); printf("cBattr: %s\n", cBattr); // 获取字段值 tinyxml2::XMLElement* dataElem = bodyElem->FirstChildElement("data"); if(dataElem != NULL){ const char* cData = dataElem->GetText(); printf("cData: %s\n", cData); } } return 0; }
-
- 打印
3.2 生成XML数据
- 代码
-
#include <stdio.h> #include <iostream> #include <tinyxml2.h> int main(){ // 初始化XML文档对象 tinyxml2::XMLDocument doc; doc.InsertEndChild(doc.NewDeclaration()); // 添加XML声明 // 创建根节点 tinyxml2::XMLElement* root = doc.NewElement("msg"); doc.InsertEndChild(root); // 在根节点下添加msg_id节点 tinyxml2::XMLElement* msgidElem = doc.NewElement("msg_id"); msgidElem->SetText("1"); root->InsertEndChild(msgidElem); // 在根节点下添加header节点 tinyxml2::XMLElement* headerElem = doc.NewElement("header"); headerElem->SetAttribute("hattr", "http"); root->InsertEndChild(headerElem); // header节点下添加type节点 tinyxml2::XMLElement* typeElem = doc.NewElement("type"); typeElem->SetText("Post"); headerElem->InsertEndChild(typeElem); // header节点下添加host节点 tinyxml2::XMLElement* hostElem = doc.NewElement("host"); hostElem->SetText("127.0.0.1"); headerElem->InsertEndChild(hostElem); // 在根节点下添加body节点 tinyxml2::XMLElement* bodyElem = doc.NewElement("body"); bodyElem->SetAttribute("battr", "base64"); root->InsertEndChild(bodyElem); // body节点下添加data节点 tinyxml2::XMLElement* dataElem = doc.NewElement("data"); dataElem->SetText("aGVsbG8="); bodyElem->InsertEndChild(dataElem); // 保存到文件 doc.SaveFile("example.xml"); return 0; }
-
- 生成的XML数据
-
<?xml version="1.0" encoding="UTF-8"?> <msg> <msg_id>1</msg_id> <header hattr="http"> <type>Post</type> <host>127.0.0.1</host> </header> <body battr="base64"> <data>aGVsbG8=</data> </body> </msg>
-