使用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;
获取根元素
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;
}
函数
外网链接
链接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的函数
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的错误类型。文章来源:https://www.toymoban.com/news/detail-803356.html
注意:这个函数只有document对象才有,其他类型的节点没有。文章来源地址https://www.toymoban.com/news/detail-803356.html
#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
到了这里,关于tinyxml2的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!