TiXml使用介绍

TiXml使用详解

本文用一个详细的例子说明了TiXml的使用方法。如写、查找、插入、替换、加载、遍历等常见操作。

TinyXML是一个简单小巧，可以很容易集成到其它程序中的C++ XML解析器。简单地说，TinyXML解析一个XML文档并由此生成一个可读可修改可保存的文档对象模型（DOM）。TinyXML使用文档对象模型（DOM），这意味着XML数据被解析成一个可被浏览和操作的C++对象，然后它可以被写到磁盘或者另一个输出流中。你也可以把C++对象构造成一个XML文档然后把它写到磁盘或者另一个输出流中。

1、TinyXml源代码只有4个cpp文件和2个头文件。

2、首先要理解TinyXml中的各个基本类型之间的关系，看看这个继承图大家就会很明白了！

可以看到TinyXml中的注释comment ，声明declaration，元素element，文本等都是节点Node的子类，也就是说可以把XMl文件中的各个元素当做节点来处理。Node类型也有到各个子类之间的转换方法，如ToElement（）转换成元素，ToDocument转换成文档等。

因此可以吧TiXmlNode作为TinyXml的基本数据类型来操作，这样转化到其他类型也比较方便！

3、类之间的关系

TinyXml实现的是DOM访问模型，因此提供了一系列的类对应XML文件中的各个节点。主要类间的关系如下：

TiXmlBase：其他类的基类，是个抽象类

TiXmlNode：表示一个节点，包含节点的一般方法，如访问子节点、兄弟节点、编辑自身、编辑子节点

TiXmlDocument：表示整个XML文档，不对应其中某个特定的节点。

TiXmlElement：表示元素节点，可以包含子节点和TiXmlAttribute

TiXmlComment：表示注释

TiXmlDeclaration：表示声明

TiXmlText：表示文本节点

TiXmlUnknown：表示未知节点，通常是出错了

TiXmlAttribute：表示一个元素的属性

下面是一个简单的例子：

<?xmlversion="1.0" encoding="utf-8" ?>

<!-This is only asample-->

<book>

   <name>TinyXml How To</name>

   <price unit=”RMB”>20</price>

   <description>Somewords…</description>

</ book >

整个文档，对应TiXmlDocument

book,name,price,description，都对应TiXmlElement

第一行对应一个TiXmlDeclaration

第二行对应一个TiXmlComment

“TinyXml How To”对应一个TiXmlText

unit则是price的一个TiXmlAttribute

这些类与XML文件中的相应元素都有很好的对应关系，因此相信参照TinyXml的文档，可以很容易的掌握各个方法的使用。

2.  需要注意的问题

各类之间的转换

由于各个节点类都从TiXmlNode继承，在使用时常常需要将TiXmlNode*类型的指针转换为其派生类的指针，在进行这种转换时，应该首先使用由TiXmlNode类提供的一系列转换函数，如ToElement(void)，而不是c++的dynamic_cast。

检查返回值

由于TinyXml是一个非校验的解析器，因此当解析一个文件时，很可能文件并不包含我们预期的某个节点，在这种情况下，TinyXml将返回空指针。因此，必须要对返回值进行检查，否则将很容易出现内存访问的错误。

如何重头建立一个XML文件

先建立一个TiXmlDocument对象，然后，载入某个模板，或者直接插入一个节点作为根节点，接着就可以像打开一个已有的XML文件那样对它进行操作了。

4、要理解TinyXml中的每个节点都可能是另一个节点的父节点这个很重要，因此遍历TinyXml文档要用递归的方法。每个节点都可能有属性，文本什么的！

5、每个type ofTiXmlNode节点的值'value'对应如下：

                Document: filename of the xmlfile

                Element: name of the element

                Comment: the comment text

                Unknown: the tag contents

                Text: the text string

6、TinyXml中Node的类型types是一个枚举类型，其成员如下：

DOCUMENT, ELEMENT,COMMENT, UNKNOWN, TEXT, and DECLARATION

7、TinyXml的在线文档和主页：

http://www.grinninglizard.com/tinyxmldocs/index.html

8、常用操作详解：

#include"tinyxml.h"

#include<iostream>

using namespace std;

 

TiXmlDocument *pDoc=NULL;

void write_xml( )

    {

 

        TiXmlDocument doc;

        TiXmlDeclaration * decl = newTiXmlDeclaration( "1.0", "", "" );

        doc.LinkEndChild( decl );

        TiXmlElement * element1 = newTiXmlElement( "AMULE_ToDL" );//创建元素element1

       element1->SetAttribute("num",5);

        doc.LinkEndChild( element1 );

 

        TiXmlElement * element11 = newTiXmlElement( "name" );

       element11->SetAttribute("name","GongFong.rmvb");//创建属性

        element1->LinkEndChild( element11);//链接element11为element1的子节点（子元素）

 

        TiXmlElement * element2 = new TiXmlElement("BT_ToDL" );

       element2->SetAttribute("num",10);    

        doc.LinkEndChild(element2);

 

        doc.SaveFile( "1.xml" );

}

 

void dump_to_stdout(TiXmlNode* pParent )//Tixml主页上给的一个遍历方法(递归调用)

{

        if ( !pParent ) return;

 

        TiXmlNode* pChild;

        TiXmlText* pText;

        int t = pParent->Type();

        printf( "type %d/n", t);

        int num;

 

        switch ( t )

        {

        case TiXmlNode::DOCUMENT:

                printf( "Document" );

                break;

 

        case TiXmlNode::ELEMENT:

                printf( "Element[%s]", pParent->Value() );

               num=dump_attribs_to_stdout(pParent->ToElement(), indent+1);

                switch(num)

                {

                        case 0:  printf( " (No attributes)"); break;

                        case 1:  printf( "%s1 attribute",getIndentAlt(indent)); break;

                        default: printf("%s%d attributes", getIndentAlt(indent), num); break;

                }

                break;

 

        case TiXmlNode::COMMENT:

               printf( "Comment:[%s]", pParent->Value());

               break;

 

        case TiXmlNode::UNKNOWN:

               printf( "Unknown" );

               break;

 

        case TiXmlNode::TEXT:

               pText = pParent->ToText();

               printf( "Text: [%s]",pText->Value() );

               break;

 

        case TiXmlNode::DECLARATION:

               printf( "Declaration");

               break;

        default:

               break;

        }

        printf( "/n" );

        for ( pChild =pParent->FirstChild(); pChild != 0; pChild = pChild->NextSibling())

        {

              dump_to_stdout( pChild );

        }

}

void search(TiXmlNode*pParent)//遍历时候，把每个节点都是做一个父节点，即假定其都有子节点ChildNode

{

       if ( !pParent ) return;

     

       TiXmlNode* pChild= NULL;

       int t = pParent->Type();//获取此节点的类型

 

       if (TiXmlNode::ELEMENT == t &&(strcmp("Welcome",pParent->Value()) == 0))//搜索元素值为"Welcome"的节点

        {

           printf("value%s/n",pParent->Value());//打印值

          pParent->SetValue("re-write");//改变其值

          pParent->ToElement()->SetAttribute("hello",20);//设置其属性

 

           TiXmlElement * element1 = newTiXmlElement( "AMULE_ToDL" );//添加一个节点

          element1->SetAttribute("num",5);

           pParent->LinkEndChild(element1);

 

           pDoc->SaveFile(); //保存文件            

        }

      printf( "/n" );

      for ( pChild = pParent->FirstChild();pChild != 0; pChild = pChild->NextSibling())

      {

           search(pChild);

      }   

}

 

int main(int argc,char* argv[])

   {

 

        TiXmlDocument doc(argv[1]);

        bool loadOkay = doc.LoadFile();

        if (loadOkay)

        {

            pDoc = &doc;

            printf("/n%s:/n",argv[1]);

            search(&doc);                //把TiXmlDocument类型的值复制给一个TiXmlNode类型

        }

        else

        {

            printf("Failed to load file/"%s/"/n", argv[1]);

        }

     return 0;

   }

9、引例

#include<iostream>

#include"tinyxml.h"

#include"tinystr.h"

#include<string>

#include<windows.h>

#include<atlstr.h>

usingnamespacestd;

 

CString GetAppPath()

{//获取应用程序根目录

 

    TCHAR modulePath[MAX_PATH];

    GetModuleFileName(NULL, modulePath,MAX_PATH);

    CString strModulePath(modulePath);

    strModulePath = strModulePath.Left(strModulePath.ReverseFind(_T('\\')));

    return strModulePath;

}

 

boolCreateXmlFile(string& szFileName)

{//创建xml文件,szFilePath为文件保存的路径,若创建成功返回true,否则false

 

    try

    {

        //创建一个XML的文档对象。

 

        TiXmlDocument *myDocument =newTiXmlDocument();

        //创建一个根元素并连接。

 

        TiXmlElement *RootElement =newTiXmlElement("Persons");

       myDocument->LinkEndChild(RootElement);

        //创建一个Person元素并连接。

 

        TiXmlElement *PersonElement =newTiXmlElement("Person");

        RootElement->LinkEndChild(PersonElement);

        //设置Person元素的属性。

 

       PersonElement->SetAttribute("ID","1");

        //创建name元素、age元素并连接。

 

        TiXmlElement *NameElement =newTiXmlElement("name");

        TiXmlElement *AgeElement =newTiXmlElement("age");

        PersonElement->LinkEndChild(NameElement);

       PersonElement->LinkEndChild(AgeElement);

        //设置name元素和age元素的内容并连接。

 

        TiXmlText *NameContent =newTiXmlText("周星星");

        TiXmlText *AgeContent =newTiXmlText("22");

        NameElement->LinkEndChild(NameContent);

       AgeElement->LinkEndChild(AgeContent);

        CString appPath = GetAppPath();

        string seperator ="\\";

        string fullPath =appPath.GetBuffer(0)+seperator+szFileName;

        myDocument->SaveFile(fullPath.c_str());//保存到文件

 

    }

    catch(string& e)

    {

        returnfalse;

    }

    returntrue;

}

 

boolReadXmlFile(string& szFileName)

{//读取Xml文件，并遍历

 

    try

    {

        CString appPath = GetAppPath();

        string seperator ="\\";

        string fullPath =appPath.GetBuffer(0)+seperator+szFileName;

        //创建一个XML的文档对象。

 

        TiXmlDocument *myDocument =newTiXmlDocument(fullPath.c_str());

        myDocument->LoadFile();

        //获得根元素，即Persons。

 

        TiXmlElement *RootElement =myDocument->RootElement();

        //输出根元素名称，即输出Persons。

 

        cout<<RootElement->Value()<<endl;

        //获得第一个Person节点。

 

        TiXmlElement *FirstPerson =RootElement->FirstChildElement();

        //获得第一个Person的name节点和age节点和ID属性。

 

        TiXmlElement *NameElement =FirstPerson->FirstChildElement();

        TiXmlElement *AgeElement =NameElement->NextSiblingElement();

        TiXmlAttribute *IDAttribute =FirstPerson->FirstAttribute();

        //输出第一个Person的name内容，即周星星；age内容，即；ID属性，即。

 

        cout<< NameElement->FirstChild()->Value()<<endl;

        cout<<AgeElement->FirstChild()->Value()<<endl;

        cout<<IDAttribute->Value()<<endl;

    }

    catch(string& e)

    {

        returnfalse;

    }

    returntrue;

}

int main()

{

    string fileName ="info.xml";

    CreateXmlFile(fileName);

    ReadXmlFile(fileName);

}