实战TinyXML

实战TinyXML

作者：裕作


（出处：http://blog.csdn.net/KyosukeNo1）



这几天在埋头写自己的3D文件浏览器（稍后发布），突发奇想的要把自己的内部格式转化成XML，于是，把以前在研究所时用过的ExPat翻了出来。 ExPat是基于事件的XML解释器，速度挺快的，但结构方面有点不敢恭维－－当年写配置文件的导出导入部分花了我足足1个星期！而且由于它是基于事件发生的次序（SAX），似乎有时会发生一些无法控制的情况－－例如进入某Level后忘了记录，结果……后面的程序全部死掉！这时想起同事之前推荐的 TinyXML，结果……用了不到3小时就把我的文件导出来了～～呵呵。在阅读本文之前，请先看看我Blog里转贴的《TinyXML学习笔记》，相信它能给各位一个关于TinyXML的初步概念。




言归正传，本文目的在于补全之前《TinyXML学习》的不足，尽量把常用的示例代码列出让大家参考。此外，在本篇最后会给出一个完整的文件读写例子，供读者参考。




1. 编程环境的设置。新建一个项目，起名叫TestTXML。到http://sourceforge.net/projects/tinyxml/ 下载TinyXML的官方例子，并编译第一个Project tinyxml（注意，最好编译Release的版本，代码比较小。然后把生成的tinyxml.lib（如果是Debug版本，叫tinyxmld.lib）连同tinystr.h和tinyxml.h一起Copy到TestTXML项目的目录中。在TestTXML项目里的头文件加入对TinyXML的引用：

#pragma comment(lib,"tinyxml.lib") // 链接Library

＃i nclude "tinyxml.h" // TinyXML的头文件




2. 建立一个XML文件：

char* sFilePath = "ikk_doc.xml"; // 文件名称

TiXmlDocument xmlDoc( sFilePath ); // 建立一个XML文件

TiXmlDeclaration Declaration( "1.0","gb2312", "yes" ); // 声明XML的属性

xmlDoc.InsertEndChild( Declaration ); // 写入基本的XML头结构

xmlDoc.SaveFile(); // 把XML文件写入硬盘

这时，在硬盘上的TestXML项目目录里，ikk_doc.xml文件已经被创建出来了。




3. 在XML文件里插入Element

所谓的Element，就是在XML里面的Tag，例如在<resume name=”裕作”>简历内容</resume>中，“Resume”就是Element的名字，上述的整个字符串就是一个Element。在TinyXML里，插入Element的步骤如下：

TiXmlElement* pElm = NULL;

pElm = new TiXmlElement( "resumes" ); //定义当前的子节点 pElmParent.InsertEndChild( *pElm ); // 把子节点插入父节点中



4. 在element里插入属性。在刚才例子中，name=”裕作”就是Resume的属性，其中name是属性的名字，”裕作”是属性的值。在当前子节点内插入属性的方法如下：

pElm->SetAttribute( "name", resume.sName );




5. 在XML里插入文本。在<resume name=”裕作”>简历内容</resume>中，“简历内容”就是一段文本，事实上，在TinyXML里，它是被当作一个Text类型的子节点来插入的。还而言之，就是在Resume的子节点中，插入这个Text子节点。插入例子如下：

TiXmlText* pText = NULL;
pText = new TiXmlText( "简历内容" ); // 定义文本的内容

pElmChild->InsertEndChild( *pText ); //把text子节点插入父节点中




在具备了以上背景知识之后，我们已经可以用TinyXML读写一个XML文件了。本文最后的程序将写入，然后重新读取一个XML文件到我们的结构里。这个XML文件的内容如下：




<?xml version="1.0" encoding="GB2312" ?>

<resumes>

<resume name="裕作">

<gender>男</gender>

<age>26</age>

<skills num="2">

<skill level="99">编程</skill>

<skill level="1">吹牛</skill>

</skills>

</resume>

<resume name="裕作 The Great">

<gender>男</gender>

<age>0</age>

<skills num="1">

<skill level="100">编程</skill>

</skills>

</resume>

</resumes>










以下程序将建立ikk_doc.xml文件，然后重新把内容读取进内存：




#pragma comment(lib,"tinyxml.lib")




＃i nclude "string.h"

＃i nclude "stdio.h"

＃i nclude "tinyxml.h"




#define XML_FILE "ikk_doc.xml"

#define NAME_LENGTH 256 // 名字类字符的分配长度

#define SAFE_DELETE(x) {if(x) delete x; x=NULL;} // 安全删除new分配出来的变量空间

#define SAFE_DELETE_ARRAY(x) {if(x) delete[] x; x=NULL;} // 安全删除new分配出来的数组空间

#define XML_HEADER "<?xml version=/"1.0/" encoding=/"GB2312/" ?>" // XML文件头的定义




typedef unsigned int uint32;




// 技能的结构

typedef struct skill_s {

uint32 nLevel; // 技能的程度

char sName[ NAME_LENGTH ]; // 技能的名称




skill_s() {

nLevel = 0;

sName[0] = 0;

}

} skill_t;




// 简历的结构

typedef struct resume_s {

char sName[ NAME_LENGTH ]; // 名字

bool isMan; // 是否男性

uint32 nAge; // 年龄

uint32 nNumSkill; // 技能的数目

skill_t* pSkill; // 技能的结构




resume_s() {

sName[0] = 0;

isMan = false;

nAge = 0;

nNumSkill = 0;

pSkill = NULL;

}

} resume_t;




void exportSkill( TiXmlElement* pElmParent, skill_t skill )

{

int i;

char sBuf[NAME_LENGTH]; // 一个临时存放的字符串

TiXmlElement* pElm = NULL; // 一个指向Element的指针

TiXmlText* pText = NULL; // 一个指向Text的指针



pElm = new TiXmlElement( "skill" );




// 插入等级（以属性形式）

sprintf( sBuf, "%d", skill.nLevel ); // 把Skill的登记变成字符串临时存进sBuf里

pElm->SetAttribute( "level", sBuf ); // 把等级插入Skill里




// 插入技能名称（以子Element形式）

pText = new TiXmlText( skill.sName ); // 建立一个Skill的子Element（一个Text形式的子元素）

pElm->InsertEndChild( *pText ); // 把这个Skill的子Element插入Skill