tinyxml2

使用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>

<!-- other nodes... -->

</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 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

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