这几天在埋头写自己的个星期!而且由于它是基于事件发生的次序(小时就把我的文件导出来了~~呵呵。在阅读本文之前,请先看看我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" ?>
<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")
#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 );
xmlDoc.SaveFile();
SAFE_DELETE(
pElm ); // 删除Element
return
true;
}
void main()
{
int
i, j;
//
+ == 设置两份简历 ==========================================================
int
nNumResume = 2;
resume_t*
pResume = new resume_t[ nNumResume ];
//
1. 初始化第一份简历
strcpy(
pResume[0].sName, "裕作" );
pResume[0].isMan
= true;
pResume[0].nAge
= 26;
pResume[0].nNumSkill
= 2;
pResume[0].pSkill
= new skill_t[2];
{
// 设置技能列表结构
strcpy(
pResume[0].pSkill[0].sName, "编程" );
strcpy(
pResume[0].pSkill[1].sName, "吹牛" );
pResume[0].pSkill[0].nLevel
= 99;
pResume[0].pSkill[1].nLevel
= 1;
}
//
2. 初始化第二份简历
strcpy(
pResume[1].sName, "裕作 The Great" );
pResume[1].isMan
= true;
pResume[1].nAge
= 0;
pResume[1].nNumSkill
= 1;
pResume[1].pSkill
= new skill_t[1];
{
// 设置技能列表结构
strcpy(
pResume[1].pSkill[0].sName, "编程" );
pResume[1].pSkill[0].nLevel
= 100;
}
//
- == 设置两份简历 ==========================================================
// 把简历以XML形式写入磁盘
if(
!writeXML( XML_FILE, nNumResume, pResume ) )
{
printf(
"ERROR: can't write the file." );
return;
}
// 删除Resume
nNumResume
= 0;
SAFE_DELETE_ARRAY(
pResume );
// 重新读入XML文件里的Resume数据
if(
!readXML( XML_FILE, &nNumResume, &pResume ) )
{
printf(
"ERROR: can't read the file." );
return;
}
// 把所有简历输出到屏幕
if(
pResume ) // 确定有Resume
{
for(
i=0; i<nNumResume; i++ ) {
printf(
"简历:======================\n" );
printf(
"\t名字:%s\n", pResume[i].sName );
if(
pResume[i].isMan )
printf(
"\t性别:男\n" );
else
printf(
"\t性别:女\n" );
printf(
"\t年龄:%d\n", pResume[i].nAge );
printf(
"\t职业技能:\n" );
for(
j=0; j<pResume[i].nNumSkill; j++ ) {
printf(
"\t\t技能名称:%s\n", pResume[i].pSkill[j].sName );
printf(
"\t\t技能等级:%d\n", pResume[i].pSkill[j].nLevel );
}
}
}
}