实战TinyXML

最新推荐文章于 2025-09-03 22:03:31 发布

yuntongsf

最新推荐文章于 2025-09-03 22:03:31 发布

阅读量644

点赞数

文章标签： delete xml null encoding 编程 struct

这几天在埋头写自己的 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

#include "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" ?>

</skills>

</resume>

</skills>

</resume>

</resumes>

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

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

#include "string.h"

#include "stdio.h"

#include "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 里

SAFE_DELETE( pText ); // 删除这个 Text

// 最后把整个 Resume 的子节点插入到父节点中

pElmParent->InsertEndChild( *pElm );

}

void importSkill( TiXmlElement* pElm, skill_t* pSkill )

{

int i;

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

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

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

// 读取 level

pSkill->nLevel = atoi( pElm->Attribute( "level" ) );

// 读取技能名称

strcpy( pSkill->sName, pElm->FirstChild()->Value() );

}

void exportResume( TiXmlElement* pElmParent, resume_t resume )

{

int i;

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

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

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

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

pElm = new TiXmlElement( "resume" );

// 插入名字（以属性形式）

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

// 插入性别（以子 Element 形式）

pElmChild = new TiXmlElement( "gender" ); // 建立一个子 Element 叫 Gender

if( resume.isMan )

pText = new TiXmlText( " 男 " ); // 建立一个 Gender 的子 Element （一个 Text 形式的子元素）

else

pText = new TiXmlText( " 女 " ); // 建立一个 Gender 的子 Element （一个 Text 形式的子元素）

pElmChild->InsertEndChild( *pText ); // 把这个 Gender 的子 Element 插入 Gender 里

pElm->InsertEndChild( *pElmChild ); // 把 Gender 插入到主 Element 里

SAFE_DELETE( pElmChild ); // 删除已经用完的 Gender

SAFE_DELETE( pText ); // 删除这个 Text

// 插入年龄（以子 Element 形式）

pElmChild = new TiXmlElement( "age" ); // 建立一个子 Element 叫 Age

sprintf( sBuf, "%d", resume.nAge ); // 把 Age 变成字符串临时存进 sBuf 里

pText = new TiXmlText( sBuf ); // 建立一个 Age 的子 Element （一个 Text 形式的子元素）

pElmChild->InsertEndChild( *pText ); // 把这个 Age 的子 Element 插入 Age 里

pElm->InsertEndChild( *pElmChild ); // 把 Age 插入到主 Element 里

SAFE_DELETE( pElmChild ); // 删除已经用完的 Age

SAFE_DELETE( pText ); // 删除这个 Text

// 插入技能子节点

pElmChild = new TiXmlElement( "skills" ); // 建立一个子 Element 叫 Skills

sprintf( sBuf, "%d", resume.nNumSkill ); // 把 Skill 的数目变成字符串临时存进 sBuf 里

pElmChild->SetAttribute( "num", sBuf ); // 把这个 Skills 的属性插入 Skills 里

for( i=0; i<resume.nNumSkill; i++ )

{

exportSkill( pElmChild, resume.pSkill[i] ); // 插入一项技能

}

pElm->InsertEndChild( *pElmChild ); // 把 Skills 插入到主 Element 里

SAFE_DELETE( pElmChild ); // 删除已经用完的 Skills

SAFE_DELETE( pText ); // 删除这个 Text

// 最后把整个 Resume 的子节点插入到父节点中

pElmParent->InsertEndChild( *pElm );

SAFE_DELETE( pElm ); // 删除子节点

}

void importResume( TiXmlElement* pElm, resume_t* pResume )

{

int i;

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

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

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

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

// 读入 "resume" 子节点

strcpy( pResume->sName, pElm->Attribute( "name" ) );

// 读入 "gender" 子节点

pElmChild = pElm->FirstChildElement( "gender" );

if( strcmp( " 男 ", pElmChild->FirstChild()->Value() ) == 0 )

pResume->isMan = true;

else

pResume->isMan = false;

// 读入 "age" 子节点

pElmChild = pElm->FirstChildElement( "age" );

pResume->nAge = atoi( pElmChild->FirstChild()->Value() );

// 读入 "skills" 子节点

pElmChild = pElm->FirstChildElement( "skills" );

pResume->nNumSkill = atoi( pElmChild->Attribute( "num" ) );

pResume->pSkill = new skill_t[pResume->nNumSkill];

pElmGrandChild = pElmChild->FirstChildElement( "skill" ); // 指向第一个 Skill

for( i=0; i<pResume->nNumSkill; i++ ) {

importSkill( pElmGrandChild, &(pResume->pSkill[i]) ); // 读取一个 Skill

pElmGrandChild = pElmGrandChild->NextSiblingElement(); // 指向下一个 Skill

}

bool readXML( char* sFilePath, int* nNumResume, resume_t** ppResume ) {

int i; // 用做循环的变量

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

TiXmlDocument xmlDoc( sFilePath ); // 输入 XML 路径

if( !xmlDoc.LoadFile() ) // 读取 XML 并检查是否读入正确

return false;

TiXmlElement* pElmRoot = NULL; // 根节点

pElmRoot = xmlDoc.FirstChildElement( "resumes" ); // 得到根节点

if( !pElmRoot ) {

return false;

}

*nNumResume = atoi( pElmRoot->Attribute( "num" ) ); // 读取 Resume 的数目

*ppResume = new resume_t[*nNumResume]; // 分配 Resume 的空间

pElmChild = pElmRoot->FirstChildElement( "resume" ); // 找出第一个 Resume

for( i=0; i<*nNumResume; i++ ) {

importResume( pElmChild, &((*ppResume)[i]) ); // 读取 Resume 的内容

pElmChild = pElmChild->NextSiblingElement(); // 找出下一个 Resume

}

return true;

}

bool writeXML( char* sFilePath, int nNumResume, resume_t* pResume )
{

if( !sFilePath || !pResume )

return false; // 确定指针存在

int i; // 用做循环的变量

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

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

TiXmlDeclaration Declaration( "1.0","gb2312", "yes" ); // 建立 XML 头结构

TiXmlDocument xmlDoc( sFilePath ); // 用存档的文件名字来建立一个 XML 文件

    xmlDoc.InsertEndChild( Declaration ); // 把 XML 头结构插入当前文档

        // 插入根节点“ Resumes”
        pElm = new TiXmlElement( "resumes" ); // 建立根节点“ Resumes”
        sprintf( sBuf, "%d", nNumResume ); // 把 nNumResume 变成字符串临时存进 sBuf 里

pElm->SetAttribute( "num", sBuf ); // 建立一个 Resumes 的子 Element

        for( i=0; i<2; i++ )
        {
            exportResume( pElm, pResume[i] ); // 在根节点上插入以上定义的 2 个简历
        }
        xmlDoc.InsertEndChild( *pElm );