当前位置：首页 > news >正文

tinyxml2

news 2025/11/10 9:17:31

使用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; }
#endif

1，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>

</root>
```

在示例中，`<root>` 是根节点。根节点可以包含其他节点，例如元素节点、注释节点、文本节点等。在 XML 解析和处理时，可以通过访问根节点来遍历整个 XML 文档，并处理其中的数据内容。

XMLNode * pRoot = xmlDoc.FirstChild();
if (pRoot == nullptr) return XML_ERROR_FILE_READ_ERROR;

获取根元素

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文件：

函数

外网链接

链接1

链接2

链接3

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的函数

`Attribute()`：获取指定名称的属性值

- `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 elementprintElementAllInfo(rootElement->FirstChildElement(),level+1);//print sibling element of this elementprintElementAllInfo(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 elementprintElementAllInfo(rootElement->FirstChildElement(),level+1);//print sibling element of this elementprintElementAllInfo(rootElement->NextSiblingElement(),level);
}

判断element中有没有text

通过GetText的返回值。

获取text----GetText()

注意GetText返回指针，而且text不一定存在，所以一定要对GetText的返回值进行判断。

获取element的下一个兄弟element

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()

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