使用tinyxml2，得知道一些xml基础
xml tutorial--菜鸟
tinyxml2类对象
结构
XMLNode
什么是节点
节点：元素、声明、文本、注释等。
XMLDocument
xml文档(文件)对象。
作用：
加载xml文件，
tinyxml2作用
先定义两个宏
#ifndef XMLCheckResultDocu
#define XMLCheckResultDocu(eResult,object) if (eResult != XML_SUCCESS) { printf("Error: %s\n", object->ErrorStr()); return eResult; }
#endif
#ifndef XMLCheckResult
#define XMLCheckResult(eResult) if (eResult != XML_SUCCESS) { printf("Error: %i\n", eResult); return eResult; }
#endif1，extract xml文件内容
提取一个元素所有属性
if(node->ToElement()) {
auto element = dynamic_cast<XMLElement*>(node);
cout << "XML 元素，name=" << element->Name() << ", value=" << element->Value() << endl;
const XMLAttribute* attribute = element->FirstAttribute();
while (attribute != nullptr) {
cout << "\t属性 " << attribute->Name() << "=" << attribute->Value() << endl;
attribute = attribute->Next();
}
}元素的name和value是什么
元素的名称（Name）指的是元素的标签名，例如 `<book>` 元素的名称为 "book"。
元素的值（Value）指的是元素包含的文本内容，也称为元素的数据（Data）。在 XML 中，元素的值位于开始标记和结束标记之间，例如 `<book>XML Basics</book>` 中的值为 "XML Basics"。
需要注意的是，元素的值和元素的属性并不是同一概念。元素的属性是位于元素开始标记中的信息，用于描述元素的附加属性和特征。元素的值则是位于元素开始标记和结束标记之间的文本内容，描述了元素的数据内容。
提取一个节点的所有子节点和兄弟节点
void traversingXML(XMLNode* node) {
printf(node->Value());
if(node->NoChildren()) return;
XMLNode* child = node->FirstChild();
while(child != nullptr) {
traversingXML(child);
child = child->NextSibling();
}
}
获取xml文档的第一个节点
注意：第一个节点不一定是element的根节点，可能是declaration，或者其他类型。
在 XML 中，根节点（root node）是整个 XML 文档的最上层节点，所有其他节点都是根节点的子节点或后代节点。
根节点是 XML 文档中唯一一个没有父节点的节点。它通常是整个 XML 文档的第一个节点，也是唯一一个与 XML 文档的命名空间相关的节点。在 XML 中，根节点与 XML 文档的首行（XML 声明）一起构成了完整的 XML 文档头部信息。
一个 XML 文件只有一个根节点，所有其他节点都是根节点的子节点，或者子节点的子节等。根节点的格式如下所示：
```xml
<?xml version="1.0" encoding="UTF-8"?>
<root>
<!-- other nodes... -->
</root>
```
在示例中，`<root>` 是根节点。根节点可以包含其他节点，例如元素节点、注释节点、文本节点等。在 XML 解析和处理时，可以通过访问根节点来遍历整个 XML 文档，并处理其中的数据内容。
XMLNode * pRoot = xmlDoc.FirstChild();
if (pRoot == nullptr) return XML_ERROR_FILE_READ_ERROR;获取根元素
XMLDocument的rootElement就可以获取；
XMLElement *pRoot=document->RootElement();
if(pRoot==nullptr){
std::cout<<"xml docuemnt empty."<<std::endl;
return XML_ERROR_EMPTY_DOCUMENT;
}自定义：
XMLElement* getRootElement(XMLNode* node){
if(node==nullptr){
std::cout<<"can not get root element,node is empty."<<std::endl;
return nullptr;
}
XMLNode *child=node;
while(child){
if(child->ToElement()!=nullptr) return (child->ToElement());
child=child->NextSibling();
}
return nullptr;
}Query查询元素指定类型的text，并且获取
QueryXXXText()
int iOutInt;
eResult = pElement->QueryIntText(&iOutInt);
XMLCheckResult(eResult);如果text不能convert为指定的类型，机会返回失败。
Query查询元素指定类型的属性，并提取
int iOutDay, iOutYear;
eResult = pElement->QueryIntAttribute("day", &iOutDay);
XMLCheckResult(eResult);
eResult = pElement->QueryIntAttribute("year", &iOutYear);
XMLCheckResult(eResult);2，创建xml文件内容
案例：
#include <iostream>
#include "tinyxml2/tinyxml2.h"
using namespace tinyxml2;
void createXML(){
XMLDocument document;
XMLDeclaration* declaration=document.NewDeclaration("xml version='1.0' encoding='UTF-8'");
XMLComment* comment=document.NewComment("This is a comment");
XMLUnknown* unknown=document.NewUnknown("unknown type");
XMLElement* person=document.NewElement("person");
person->SetAttribute("name","laowang");
person->SetAttribute("age","22");
person->SetAttribute("gender","man");
XMLElement* addr=document.NewElement("address");
addr->SetAttribute("name","guangnan");
addr->SetAttribute("postion","sourthwest");
XMLElement* enterprise=document.NewElement("enterprise");
enterprise->SetAttribute("first","stuudent");
enterprise->SetAttribute("second","xiaobai");
enterprise->SetAttribute("third","peitian");
XMLElement* success=document.NewElement("success");
success->SetAttribute("stage","highest");
XMLText* text=document.NewText("baby to you");
success->InsertEndChild(text);
enterprise->InsertEndChild(success);
person->InsertEndChild(addr);
person->InsertEndChild(enterprise);
document.InsertEndChild(declaration);
document.InsertEndChild(comment);
document.InsertEndChild(unknown);
document.InsertEndChild(person);
document.SaveFile("person.xml");
}
int main(){
createXML();
return 0;
}生成的xml文件：
SaveFile
XMLError XMLDocument::SaveFile( const char* filename, bool compact )compact---契约，协定；
- `filename`：需要保存到的文件的路径。
- `compact`：是否以紧凑模式输出 XML。如果为 `true`，则输出无缩进的紧凑格式，如果为 `false`，则输出带有缩进的可读性较好的 XML 格式，默认为 `false`---有缩进。
新增的节点
新增加的节点一定要再次SaveFile()，要不然没有保持到文件。
#include <iostream>
#include "tinyxml2/tinyxml2.h"
using namespace tinyxml2;
#ifndef XMLCheckResult
#define XMLCheckResult(a_eResult) if (a_eResult != XML_SUCCESS) { printf("Error: %i\n", a_eResult); return a_eResult; }
#endif
int createXml(){
XMLDocument document;
XMLDeclaration* declaration=document.NewDeclaration("xml version=\"1.0\" encoding=\"UTF-8\"");
XMLComment* comment=document.NewComment("This is a comment");
XMLUnknown* unknown=document.NewUnknown("unknown type");
XMLElement* person=document.NewElement("person");
person->SetAttribute("name","laowang");
person->SetAttribute("age","22");
person->SetAttribute("gender","man");
XMLElement* addr=document.NewElement("address");
addr->SetAttribute("name","guangnan");
addr->SetAttribute("postion","sourthwest");
XMLElement* enterprise=document.NewElement("enterprise");
enterprise->SetAttribute("first","student");
enterprise->SetAttribute("second","xiaobai");
enterprise->SetAttribute("third","peitian");
// enterprise->SetText("set text");
// enterprise->SetName("set name");
// enterprise->SetValue("100");
XMLElement* success=document.NewElement("success");
success->SetAttribute("stage","highest");
XMLText* text=document.NewText("baby to you");
success->InsertEndChild(text);
enterprise->InsertEndChild(success);
person->InsertEndChild(addr);
person->InsertEndChild(enterprise);
document.InsertEndChild(declaration);
document.InsertEndChild(comment);
document.InsertEndChild(unknown);
document.InsertEndChild(person);
XMLError eRusult=document.SaveFile("person.xml");
XMLCheckResult(eRusult);
XMLElement *money=document.NewElement("money");
person->InsertEndChild(money);
}
int main(){
createXml();
return 0;
}
savefile:
#include <iostream>
#include "tinyxml2/tinyxml2.h"
using namespace tinyxml2;
#ifndef XMLCheckResult
#define XMLCheckResult(a_eResult) if (a_eResult != XML_SUCCESS) { printf("Error: %i\n", a_eResult); return a_eResult; }
#endif
int createXml(){
XMLDocument document;
XMLDeclaration* declaration=document.NewDeclaration("xml version=\"1.0\" encoding=\"UTF-8\"");
XMLComment* comment=document.NewComment("This is a comment");
XMLUnknown* unknown=document.NewUnknown("unknown type");
XMLElement* person=document.NewElement("person");
person->SetAttribute("name","laowang");
person->SetAttribute("age","22");
person->SetAttribute("gender","man");
XMLElement* addr=document.NewElement("address");
addr->SetAttribute("name","guangnan");
addr->SetAttribute("postion","sourthwest");
XMLElement* enterprise=document.NewElement("enterprise");
enterprise->SetAttribute("first","student");
enterprise->SetAttribute("second","xiaobai");
enterprise->SetAttribute("third","peitian");
// enterprise->SetText("set text");
// enterprise->SetName("set name");
// enterprise->SetValue("100");
XMLElement* success=document.NewElement("success");
success->SetAttribute("stage","highest");
XMLText* text=document.NewText("baby to you");
success->InsertEndChild(text);
enterprise->InsertEndChild(success);
person->InsertEndChild(addr);
person->InsertEndChild(enterprise);
document.InsertEndChild(declaration);
document.InsertEndChild(comment);
document.InsertEndChild(unknown);
document.InsertEndChild(person);
XMLError eRusult=document.SaveFile("person.xml");
XMLCheckResult(eRusult);
XMLElement *money=document.NewElement("money");
money->SetAttribute("salary",100000);
person->InsertEndChild(money);
eRusult=document.SaveFile("person.xml");
XMLCheckResult(eRusult);
}
int main(){
createXml();
return 0;
}
函数
new类型的函数
比如newElement()
XMLNode * InsertFirstChild(XMLNode *addThis)
XMLNode * InsertAfterChild(XMLNode *afterThis, XMLNode *addThis)
XMLNode * InsertEndChild(XMLNode *addThis)
void DeleteChild(XMLNode *node)
void DeleteChildren()
SetText()
重载函数，参数类型可以多种。
设置text的。
所以说，一个元素的text可以建立XMLText对象，然后insert;也可以用这个函数直接生成。
SetValue()
设置元素名称
element的函数
element的构造函数
private:
XMLElement( XMLDocument* doc );
virtual ~XMLElement();
XMLElement( const XMLElement& ); // not supported
void operator=( const XMLElement& ); // not supported
也没有下面的构造函数：
tinyxml2::XMLElement* element = new tinyxml2::XMLElement("element_name");
所有的XML对象原点都需要通过XMLDocument对象建立，不能建立独立的节点对象（除了XMLDocument）：
int createXml(){
XMLDocument document;
XMLDeclaration* declaration=document.NewDeclaration("xml version='1.0' encoding='UTF-8'");
XMLComment* comment=document.NewComment("This is a comment");
XMLUnknown* unknown=document.NewUnknown("unknown type");
XMLElement* person=document.NewElement("person");
person->SetAttribute("name","laowang");
person->SetAttribute("age","22");
person->SetAttribute("gender","man");
XMLElement* addr=document.NewElement("address");
addr->SetAttribute("name","guangnan");
addr->SetAttribute("postion","sourthwest");
XMLElement* enterprise=document.NewElement("enterprise");
enterprise->SetAttribute("first","stuudent");
//enterprise->SetAttribute("second","xiaobai");
//enterprise->SetAttribute("third","peitian");
enterprise->SetText("set text");
enterprise->SetName("set name");
enterprise->SetValue("100");
XMLElement* success=document.NewElement("success");
success->SetAttribute("stage","highest");
XMLText* text=document.NewText("baby to you");
success->InsertEndChild(text);
enterprise->InsertEndChild(success);
person->InsertEndChild(addr);
person->InsertEndChild(enterprise);
document.InsertEndChild(declaration);
document.InsertEndChild(comment);
document.InsertEndChild(unknown);
document.InsertEndChild(person);
XMLError eRusult=document.SaveFile("person.xml");
XMLCheckResult(eRusult);
}
`Attribute()`：获取指定名称的属性值
XMLError query(XMLDocument* document){
XMLNode* ret=document->FirstChild();
if(ret==nullptr) return XML_ERROR_EMPTY_DOCUMENT;
XMLElement *pRoot=document->RootElement();
const char* value=pRoot->Attribute("age");
if(std::string(value)=="22"){
std::cout<<"age=22"<<std::endl;
}
}
- `FindAttribute()`：查找指定名称的属性
- `FirstAttribute()`：获取第一个属性
element对text的处理函数
XMLElement中，name,value,text的区别
name和value返回的都是元素的name，GetText返回的才是元素的text.
Value():
void printElementAllInfo(XMLElement* rootElement,int level){
if(rootElement==nullptr) return;
int le=level;
while(le--) std::cout<<" ";
std::cout<<"element name:"<<rootElement->Name();
// if(rootElement->GetText()){
// std::cout<<"text data:"<<rootElement->GetText();
// }
if(rootElement->Value()){
std::cout<<" text data:"<<rootElement->Value();
}
std::cout<<std::endl;
le=level;
while(le--) std::cout<<" ";
std::cout<<rootElement->Name()<<" attribute:"<<std::endl;
const XMLAttribute* attirbute=rootElement->FirstAttribute();
while(attirbute){
le=level;
while(le--) std::cout<<" ";
std::cout<<attirbute->Name()<<"="<<attirbute->Value()<<std::endl;
attirbute=attirbute->Next();
}
//print child element of his element
printElementAllInfo(rootElement->FirstChildElement(),level+1);
//print sibling element of this element
printElementAllInfo(rootElement->NextSiblingElement(),level);
}
GetText():
void printElementAllInfo(XMLElement* rootElement,int level){
if(rootElement==nullptr) return;
int le=level;
while(le--) std::cout<<" ";
std::cout<<"element name:"<<rootElement->Name();
if(rootElement->GetText()){
std::cout<<"text data:"<<rootElement->GetText();
}
std::cout<<std::endl;
le=level;
while(le--) std::cout<<" ";
std::cout<<rootElement->Name()<<" attribute:"<<std::endl;
const XMLAttribute* attirbute=rootElement->FirstAttribute();
while(attirbute){
le=level;
while(le--) std::cout<<" ";
std::cout<<attirbute->Name()<<"="<<attirbute->Value()<<std::endl;
attirbute=attirbute->Next();
}
//print child element of his element
printElementAllInfo(rootElement->FirstChildElement(),level+1);
//print sibling element of this element
printElementAllInfo(rootElement->NextSiblingElement(),level);
}
判断element中有没有text
通过GetText的返回值。
获取text----GetText()
注意GetText返回指针，而且text不一定存在，所以一定要对GetText的返回值进行判断。
获取element的下一个兄弟element---NextSiblingElement("")
rootElement->NextSiblingElement()不知道参数，则获取下一个任意兄弟节点，指定参数，则获取指定标签的下一个兄弟节点。
获取元素的子元素---firstChildElement()
获取第一个子元素
XMLElement * pElement = pRoot->FirstChildElement();//不使用参数，默认获取第一个子元素
if (pElement == nullptr) return XML_ERROR_PARSING_ELEMENT;使用元素名称获取元素的指定子元素
XMLElement * pElement = pRoot->FirstChildElement("IntValue");
if (pElement == nullptr) return XML_ERROR_PARSING_ELEMENT;确保子元素名不同。
attribute的函数
提取属于同一个元素的当前属性的下一个属性---Next()
XMLNode的函数
企图当前节点的下一个兄弟节点---NextSibling()
XMLElement* getRootElement(XMLNode* node){
if(node==nullptr){
std::cout<<"can not get root element,node is empty."<<std::endl;
return nullptr;
}
XMLNode *child=node;
while(child){
if(child->ToElement()!=nullptr) return (child->ToElement());
child=child->NextSibling();
}
return nullptr;
}element因为继承这个，所以有：
1，NextSibling()----注意，这个获取的不一定是element
2，NextSiblingElement()
firstChild()--提取一个节点
注意，firstChild提取的不一定是element，因为这个函数提取的是节点，而不是元素。
element因为继承XMLNode,所以有：
1，firstChild()---注意，这个获取的不一定是element
2，firstChildElement()
XMLDocument的函数
NewElement("")
XMLDocument对象内部使用自定义的动态数组记录document对象创建的每一个成员。
但是有时候，因为XMLElement不能自己创建无关的XMLElement对象。所以需要document创建一个无关的XMLElement返回，这个时候返回的对象对document有没有影响。
《底层的实现就是建立好XMLDocument对象的节点和属性，写文件的时候根据这些属性生成XML文件》
即使document创建了，只要没有insert，写文件的时候也不会写进xml文件。
如果已经Insert，但是写文件失败，那么再写这个应该会被写进去。
XMLText()
text有两种：
1，独立的，不包含在element中的text；
2，包含在text中的text。
不包含在element中的text-----利用tinyxml2生成的text(text1和text2)如下：
int createXml(){
XMLDocument document;
XMLDeclaration* declaration=document.NewDeclaration("xml version=\"1.0\" encoding=\"UTF-8\"");
XMLComment* comment=document.NewComment("This is a comment");
XMLUnknown* unknown=document.NewUnknown("unknown type");
XMLElement* person=document.NewElement("person");
person->SetAttribute("name","laowang");
person->SetAttribute("age","22");
person->SetAttribute("gender","man");
XMLElement* addr=document.NewElement("address");
addr->SetAttribute("name","guangnan");
addr->SetAttribute("postion","sourthwest");
XMLElement* enterprise=document.NewElement("enterprise");
enterprise->SetAttribute("first","student");
enterprise->SetAttribute("second","xiaobai");
enterprise->SetAttribute("third","peitian");
XMLElement* success=document.NewElement("success");
success->SetAttribute("stage","highest");
XMLText* text=document.NewText("baby to you");
XMLText* text2=document.NewText("text2");
success->InsertEndChild(text);
enterprise->InsertEndChild(success);
person->InsertEndChild(addr);
person->InsertEndChild(text2);//text2的添加
person->InsertEndChild(enterprise);
XMLText* text1=document.NewText("text1");
document.InsertEndChild(declaration);
document.InsertEndChild(comment);
document.InsertEndChild(unknown);
document.InsertEndChild(text1);//text1的添加
document.InsertEndChild(person);
XMLError eRusult=document.SaveFile("person.xml");
XMLCheckResult(eRusult);
XMLElement *money=document.NewElement("money");
money->SetAttribute("salary",100000);
person->InsertEndChild(money);
eRusult=document.SaveFile("person.xml");
XMLCheckResult(eRusult);
}获取XMLText的值--Value()
Value()
设置XMLText的值---SetValue()
XMLError query(XMLDocument* document){
XMLNode* ret=document->FirstChild();
if(ret==nullptr) return XML_ERROR_EMPTY_DOCUMENT;
XMLElement *pRoot=document->RootElement();
XMLNode *node=pRoot->FirstChild();
while(node){
if(node->ToText()){
std::cout<<"old text:"<<node->Value()<<std::endl;
node->SetValue("old to new");
std::cout<<"new text:"<<node->Value()<<std::endl;
document->SaveFile("../person.xml");
return XML_SUCCESS;
}
node=node->NextSibling();
}
return XML_SUCCESS;
}
tinyxml2错误枚举
文件读取错误
if (pRoot == nullptr) return XML_ERROR_FILE_READ_ERROR;元素解析错误
XMLElement * pElement = pRoot->FirstChildElement("IntValue");
if (pElement == nullptr) return XML_ERROR_PARSING_ELEMENT;属性解析错误
szAttributeText = pElement->Attribute("month");
if (szAttributeText == nullptr) return XML_ERROR_PARSING_ATTRIBUTE;
std::string strOutMonth = szAttributeText;XMLError
enum XMLError {
XML_SUCCESS = 0,
XML_NO_ATTRIBUTE,
XML_WRONG_ATTRIBUTE_TYPE,
XML_ERROR_FILE_NOT_FOUND,
XML_ERROR_FILE_COULD_NOT_BE_OPENED,
XML_ERROR_FILE_READ_ERROR,
XML_ERROR_PARSING_ELEMENT,
XML_ERROR_PARSING_ATTRIBUTE,
XML_ERROR_PARSING_TEXT,
XML_ERROR_PARSING_CDATA,
XML_ERROR_PARSING_COMMENT,
XML_ERROR_PARSING_DECLARATION,
XML_ERROR_PARSING_UNKNOWN,
XML_ERROR_EMPTY_DOCUMENT,
XML_ERROR_MISMATCHED_ELEMENT,
XML_ERROR_PARSING,
XML_CAN_NOT_CONVERT_TEXT,
XML_NO_TEXT_NODE,
XML_ELEMENT_DEPTH_EXCEEDED,
XML_ERROR_COUNT
};ErrorStr()
当发生错误时，可以直接使用节点对象的ErrorStr()成员函数输出XMLError的错误类型。
注意：这个函数只有document对象才有，其他类型的节点没有。
#ifndef XMLCheckResultDocu
#define XMLCheckResultDocu(eResult,object) if (eResult != XML_SUCCESS) { printf("Error: %s\n", object->ErrorStr()); return eResult; }
#endif
#ifndef XMLCheckResult
#define XMLCheckResult(eResult) if (eResult != XML_SUCCESS) { printf("Error: %i\n", eResult); return eResult; }
#endif
381
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
