記錄一些TinyXml使用指南(4)

實戰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

#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 );

            }

        }

    }

}