Tinyxml2学习

转自http://www.360doc.com/content/13/1223/16/3684846_339528825.shtml,尊重原文

什么是XML?

XML全称EXtensible Markup Language,翻译为可扩展标记语言,简而言之就是你可以自定义数据的标识,以此来区分各种不同的数据,以便于进行数据交换,例如html就可以理解为一种简单的xml语言。XML文件通常就是一个文本文件,可以使用任何编码。

上图就是我系统中一个xml文件的图标,使用VC2005打开它,你可以看到如下内容:

XML也是有这几个对象组成了,一般来说我们经常使用的类如下:

l TiXmlDocument:文档类,它代表了整个xml文件。

l TiXmlDeclaration:声明类,它表示文件的声明部分,如上图所示。

l TiXmlComment:注释类,它表示文件的注释部分,如上图所示。

l TiXmlElement:元素类,它是文件的主要部分,并且支持嵌套结构,一般使用这种结构来分类的存储信息,它可以包含属性类和文本类,如上图所示。

n TiXmlAttribute/TiXmlAttributeSet:元素属性,它一般嵌套在元素中,用于记录此元素的一些属性,如上图所示。

n TiXmlText:文本对象,它嵌套在某个元素内部,如上图所示。

保存文档对象

当然你也可以使用SaveFile()函数来进行另存为,这个函数的原形如下:

bool SaveFile( const std::string& filename ) const

在程序中你可以如下使用:

//载入xml文档

TiXmlDocument doc("tutorial.xml");

doc.LoadFile();

doc.Print(); //输出文档

cout<<endl;

doc.SaveFile("tutorial.txt");

使用记事本打开tutorial.txt,你可以看到如下内容。

返回第一个根元素

另外文档对象还提供了一个实用的函数用于返回第一个根对象,它可以让你方便的遍历整个文档结构,查找自己需要的数据。函数原形如下:

+TiXmlElement* RootElement()

我们在介绍元素类的时候再详细介绍它的使用。

声明类

在标准的XML文件中,声明为文件的第一项,例如<?xml version="1.0" standalone="yes"?>,声明对象具有三个属性值,版本,编码和独立文件声明

一般来说文档的第一行就是声明对象,你可以把文档对象的第一个子节点转换为声明对象。

//使用TinyXml的声明对象

TiXmlDeclaration *decl;

decl = doc.FirstChild()->ToDeclaration();

然后就可以使用它的功能了,它可以让你返回当前的版本,编码等信息,函数原形如下:

+const char *Version() const

+const char *Encoding() const

+const char *Standalone() const

在程序中你可以如下使用:

//使用TinyXml的声明对象

TiXmlDeclaration *decl;

decl = doc.FirstChild()->ToDeclaration();

cout<<"使用TinyXml的声明对象(TiXmlDeclaration)"<<endl;

//输出声明对象对应的xml内容

decl->Print(0,4,&str);

cout<<str<<endl;

//分别输出声明对象的属性

cout<<"版本:"<<decl->Version()<<" 是否为对立文件:"<<decl->Standalone()<<" 编码方式:"<<decl->Encoding()<<endl;

cout<<endl;

注释类

这个类一般为xml数据提供解释说明,在程序中一般不使用它,因此,这里就不介绍了。

元素类

元素为一个容器类,它具有元素名称,并可以包含其它元素,文本,注释和未知节点,这些对象统称为元素的节点,即节点可以为元素、文本、注释和未知节点类型。元素也可以包含任意个数的属性。

我们还是以如下的XML代码来说明这个类的功能。

<element attribute="this a attribute(这是一个属性)" int= "1" float = "3.14">

<subelement1>

This a text(这是一个文本)

</subelement1>

<subelement2/>

<subelement3/>

<subelement4/>

</element>

节点名

在上方元素的代码中,element为根元素的名称,你可以通过如下的函数来设置和返回它。

+const std::string& ValueStr() const

+void SetValue( const std::string& _value )

父节点

subelement1,subelement2,subelement3,subelement4都是element的子元素,如果当前元素对象的指针指向subelement1,subelement2,subelement3,subelement4,你可以通过Parent()函数来返回指向element对象的指针,Parent()函数的声明如下:

+TiXmlNode* Parent()

子节点

通过父节点的指针,你可以遍历所有的子节点。

+TiXmlNode* FirstChild()

+TiXmlNode* FirstChild( const std::string& _value )

上面两个函数用于返回第一个子节点对象的指针,带参数名的那个函数表示返回第一个名为_value的子节点。

+TiXmlNode* LastChild()

+TiXmlNode* LastChild( const std::string& _value )

上面的两个函数用于返回最后一个节点对象的指针,带参数名的那个函数表示返回最后一个名为_value的子节点。

你也可以使用IterateChildren()函数来依次遍历所有的节点,它们的函数声明如下:

+TiXmlNode* IterateChildren( const TiXmlNode* previous )

+TiXmlNode* IterateChildren( const std::string& _value, const TiXmlNode* previous )

带参数名的那个函数表示只遍历同名的节点。

编辑子节点

你可以插入、删除替换所有的子节点。

+TiXmlNode* InsertEndChild( const TiXmlNode& addThis );

+TiXmlNode* InsertBeforeChild( TiXmlNode* beforeThis, const TiXmlNode& addThis );

+TiXmlNode* InsertAfterChild( TiXmlNode* afterThis, const TiXmlNode& addThis );

上面三个函数用于插入节点,InsertEndChild函数让你把新节点插入到末尾,InsertBeforeChild和InsertAfterChild函数允许你在指定的节点位置前后插入节点。

+TiXmlNode* ReplaceChild( TiXmlNode* replaceThis, const TiXmlNode& withThis );

ReplaceChild函数用于替换指定的节点。

+bool RemoveChild( TiXmlNode* removeThis );

RemoveChild函数让你删除指定的节点。

void Clear();

Clear函数会删除本节点的所有子节点(包括子节点包含的从子节点),但不会修改本节点。

同级节点

<element attribute="this a attribute(这是一个属性)" int= "1" float = "3.14">

<subelement1>

This a text(这是一个文本)

</subelement1>

<subelement2/>

<subelement3/>

<subelement4/>

</element>

在上面的xml代码中,subelement1、subelement2、subelement3、subelement4都属于同级节点,我们也提供了相关的函数用于在这些同级节点中遍历。

+TiXmlNode* PreviousSibling()

+TiXmlNode* PreviousSibling( const std::string& _value )

可以根据当前的节点,返回上一个节点的指针。带参数名的那个函数表示返回上一个名为_value的节点。

当然你也可以根据当前的节点,返回下一个节点的指针。带参数名的那个函数表示返回下一个名为_value的节点。

+TiXmlNode* NextSibling()

+TiXmlNode* NextSibling( const std::string& _value)

遍历元素

元素是一种特殊的节点,以‘<‘为开始字符,后接元素名称。函数NextSiblingElement用于返回下一个同级元素,而忽略其它类型的节点。它们的函数声明如下:

+TiXmlElement* NextSiblingElement()

+TiXmlElement* NextSiblingElement( const std::string& _value)

带参数名的那个函数表示返回下一个名为_value的同级元素。

本类也提供了相关的函数,让你返回第一个子元素。

+TiXmlElement* FirstChildElement()

+TiXmlElement* FirstChildElement( const std::string& _value )

带参数名的那个函数表示返回下一个名为_value的子元素。

元素属性

属性一般保存在元素中,它们为使用"="号连接的两个字符串,左边的表示属性名,等号右边的表示属性值,通常使用字符串、整数和浮点数等数据类型表示。例如,pi = 3.14。

你可以通过如下的函数,返回属性值。

+const std::string* Attribute( const std::string& name ) const;

+const std::string* Attribute( const std::string& name, int* i ) const;

+const std::string* Attribute( const std::string& name, double* d ) const;

在上面3个函数中,第一个函数使用字符串保存返回的属性值,第二个函数把属性值转换为整数然后返回,第三个函数把属性值转换为浮点数然后返回。不过,第二、三个函数都会以字符串的形式记录属性值,并作为函数的返回值返回。

另外,你也可以使用模板函数:

+template< typename T > int QueryValueAttribute( const std::string& name, T* outValue ) const

来返回特点的属性值,它会根据你传入的参数,自动选择合适数据类型。

另外,本类也提供了如下三个函数让你设置属性,参数的类型和返回函数类似。

+void SetAttribute( const std::string& name, const std::string& _value );

+void SetAttribute( const std::string& name, int _value );

+void SetDoubleAttribute( const char * name, double value );

FirstAttribute和LastAttribute可以让你返回第一个和最后一个属性,它们的函数声明如下:

+TiXmlAttribute* FirstAttribute()

+TiXmlAttribute* LastAttribute()

RemoveAttribute函数可以让你删除指定名称的属性,它的函数声明如下:

+void RemoveAttribute( const std::string& name )

元素函数总结

ValueStr //返回元素名称

SetValue //设置元素名称

Parent //返回父节点对象

FirstChild //返回第一个子节点

LastChild //返回最后一个子节点

IterateChildren //返回下一个子节点

InsertEndChild //在最后一个子节点后插入子节点

InsertBeforeChild //在指定的子节点前插入子节点

InsertAfterChild //在指定的子节点后插入子节点

ReplaceChild //替换指定的子节点

RemoveChild //删除指定的子节点

Clear //删除所有的子节点

PreviousSibling //返回同级中前一个节点

NextSibling //返回同级中后一个节点

NextSiblingElement //返回同级中后一个元素

FirstChildElement //返回第一个子元素节点

Attribute //返回元素中的属性值

QueryValueAttribute //返回元素中的属性值

SetAttribute //设置元素中的属性值

FirstAttribute //返回元素中第一个属性对象

LastAttribute //返回元素中最后一个属性对象

RemoveAttribute //删除元素中指定的属性对象

属性类

属性为名称="值"对,元素可以具有属性值,但名称必须唯一。

你可以通过

+const std::string& NameTStr() const

返回属性名称

也可以通过下面三个函数返回属性值:

+const std::string& ValueStr() const

+int IntValue() const;

+double DoubleValue() const;

当然你也可以设置属性值,它们的函数声明如下:

+void SetName( const std::string& _name )

+void SetIntValue( int _value );

+void SetDoubleValue( double _value );

+void SetValue( const std::string& _value )

以上函数与元素类中的相关函数类似,这里不重复介绍了。

在元素属性中,通常具有许多属性,你可以通过Next函数返回下一个属性对象的指针,也可以通过Previous函数获得上一个属性对象的指针。它们的函数声明如下:

+TiXmlAttribute* Next()

+TiXmlAttribute* Previous()

TinyXml使用文档对象模型(DOM)来解析xml文件,这种模型的处理方式为在分析时,一次性的将整个XML文档进行分析,并在内存中形成对应的树结构,同时,向用户提供一系列的接口来访问和编辑该树结构。这种方式占用内存大,但可以给用户提供一个面向对象的访问接口,对用户更为友好,非常方便用户使用。下面我们依次来介绍各个类的用法。

文档类

文档类代表一个XML文档,通过它,你可以保存,载入和打印输出文档。你可以通过以下方式载入xml文档到TiXmlDocument。

创建文档对象

l 创建一个空的文档对象,然后载入一个xml文档

使用到的函数原形如下:

+TiXmlDocument();

+bool LoadFile( const std::string& filename)

在程序中你可以如下使用:

//载入xml文档

TiXmlDocument doc();

doc.LoadFile("tutorial.xml");

l 2、在构造函数中传入文档的名称,然后调用load函数完成解析载入

使用到的函数原形如下:

+TiXmlDocument( const std::string& documentName );

+bool LoadFile();

在程序中你可以如下使用:

//载入xml文档

TiXmlDocument doc("tutorial.xml");

doc.LoadFile();

输出文档对象

文档类提供了Print()函数用于在控制台输出当前的文档内容,这个函数的原形如下:

+void Print() const

在程序中你可以如下使用:

//载入xml文档

TiXmlDocument doc("tutorial.xml");

doc.LoadFile();

doc.Print(); //输出文档

tutorial.xml的内容如下:

<?xml version="1.0" standalone="yes" encoding="utf-8"?>

<!--comment 注释-->

<element attribute="this a attribute(这是一个属性)" int= "1" float = "3.14">

<subelement1>

This a text(这是一个文本)

</subelement1>

<subelement2/>

<subelement3/>

<subelement4/>

</element>

在控制台中你可以得到如下输出:

由于文件使用UTF-8编码,而Windows下的控制台默认使用gb2312编码,因此会生成乱码。

时间: 2024-10-26 06:55:18

Tinyxml2学习的相关文章

学习C++版XML解析器tinyxml2

tinyxml2是一个非常好用的C++编写的XML文件解析和生成器,其项目地址为:https://github.com/leethomason/tinyxml2 下面给出常用的API: 主要API: XMLDocument:XML文档类 RootElement():XML文档的root元素 XMLElement:XML元素对象 FirstChildElement():第一个子节点 NextSiblingElement():下一个兄弟节点 XMLAttribute:XML节点属性类 FirstAt

关于自动寻径和图、邻接表的学习和启发

以后的游戏中可能会用到人物的自动寻径,在网上看到一个非常不错的博文,特学习了一下,并转了过来为以后留着... 再次感谢 Siliphen的分享,本文转载自 http://blog.csdn.net/stevenkylelee/article/details/38408253 本文乃Siliphen原创,转载请注明出处:http://blog.csdn.net/stevenkylelee 本文的实现使用的环境是:Cocos2d-x 3.2,VS2013 本文,我们最终实现的地图行走效果如下2图:

值得学习的C/C++开源框架(转)

值得学习的C语言开源项目 - 1. Webbench Webbench是一个在linux下使用的非常简单的网站压测工具.它使用fork()模拟多个客户端同时访问我们设定的URL,测试网站在压力下工作的性能,最多可以模拟3万个并发连接去测试网站的负载能力.Webbench使用C语言编写, 代码实在太简洁,源码加起来不到600行. 下载链接:http://home.tiscali.cz/~cz210552/webbench.html - 2. Tinyhttpd tinyhttpd是一个超轻量型Ht

值得学习的C语言开源项目

- 1. Webbench Webbench是一个在linux下使用的非常简单的网站压测工具.它使用fork()模拟多个客户端同时访问我们设定的URL,测试网站在压力下工作的性能,最多可以模拟3万个并发连接去测试网站的负载能力.Webbench使用C语言编写, 代码实在太简洁,源码加起来不到600行. 下载链接:http://home.tiscali.cz/~cz210552/webbench.html - 2. Tinyhttpd tinyhttpd是一个超轻量型Http Server,使用C

C++的一些不错开源框架,可以学习和借鉴

larryjiang 我的文章 我的文档 我的文集 我的收藏 我的草稿 我的微博 我的投票 我的活动 我的相册 我的日历 退出登录 × 查看26条@我的微博 查看1条系统消息 查看44条@我的微博 创建文章 创建活动 创建相册 创建投票 创建文集 创建定时短信 手机KM 频道 研发月报 腾讯月刊 Q益平台 微爱益起来 职业发展 总办交流 KM周刊 乐问周刊 应用 活动 投票 相册 文集 幻灯片 祝福卡 定时短信 达人堂 实验室 期刊 工作圈 我的K吧 K吧排序 浏览K吧 | 创建K吧 KM平台组

TinyXML2的使用

最近项目上需要用到XML,然后简单的学习了一下XML,在此简单描述XML中的元素解析过程,学习例子来自于 http://blog.csdn.net/educast/article/details/12908455 去这里获取XML解析器的文件,我们只需要tinyxml2.h和tinyxml2.cpp,将他们拷到工程目录里面. 1.XML元素内容的获取 创建一个简单的xml文件 1 <?xml version="1.0"?> 2 <Hello> 3 World 4

c++技术系统学习资料

原文地址:http://www.open-open.com/bbs/view/1323401558374 1.C++各大有名库的介绍--C++标准库 2.C++各大有名库的介绍--准标准库Boost 3.C++各大有名库的介绍--GUI 4.C++各大有名库的介绍--网络通信 5.C++各大有名库的介绍--XML 6.C++各大有名库的介绍--科学计算 7.C++各大有名库的介绍--游戏开发 8.C++各大有名库的介绍--线程 9.C++各大有名库的介绍--序列化 10.C++各大有名库的介绍-

Cocos2d-x学习笔记(十三)—— 数据解析(json/xml)

在我们获取网络数据时,基本上使用的都是xml以及json,因此学习对这两种数据进行解析,对我们有很大的帮助. 下面是代码: HelloParse.h: <span style="font-size:18px;">#ifndef __HELLOPARSE_H__ #define __HELLOPARSE_H__ #include "cocos2d.h" using namespace cocos2d; class HelloParse : public c

【转】值得学习的C语言开源项目和库

- 1. Webbench Webbench是一个在linux下使用的非常简单的网站压测工具.它使用fork()模拟多个客户端同时访问我们设定的URL,测试网站在压力下工作的性能,最多可以模拟3万个并发连接去测试网站的负载能力.Webbench使用C语言编写, 代码实在太简洁,源码加起来不到600行. 下载链接:http://home.tiscali.cz/~cz210552/webbench.html - 2. Tinyhttpd tinyhttpd是一个超轻量型Http Server,使用C