TiXml使用详解

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

首先简单介绍一下TinyXml，要看详细的在网上搜搜了^_^:

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：表示一个元素的属性
下面是一个简单的例子：
<?xml version="1.0" encoding="utf-8"?>
<!-This is only a sample-->
<book>
  <name>TinyXml HowTo</name>
  <priceunit=”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 of TiXmlNode节点的值'value'对应如下 ：

               Document: filename of the xml file

               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, andDECLARATION
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 = new TiXmlDeclaration( "1.0", "", "");
       doc.LinkEndChild( decl );

       TiXmlElement * element1 = new TiXmlElement( "AMULE_ToDL");//创建元素element1
       element1->SetAttribute("num",5);
       doc.LinkEndChild( element1 );

       TiXmlElement * element11 = new TiXmlElement( "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;
       intt = 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 = new TiXmlElement( "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("Failedto 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>
using namespace std;

CString GetAppPath()
{//获取应用程序根目录

    TCHARmodulePath[MAX_PATH];
    GetModuleFileName(NULL,modulePath,MAX_PATH);
    CStringstrModulePath(modulePath);
    strModulePath=strModulePath.Left(strModulePath.ReverseFind(_T('\\')));
    returnstrModulePath;
}

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

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

        TiXmlDocument*myDocument = new TiXmlDocument();
        //创建一个根元素并连接。

        TiXmlElement*RootElement = new TiXmlElement("Persons");
        myDocument->LinkEndChild(RootElement);
        //创建一个Person元素并连接。

        TiXmlElement*PersonElement= new TiXmlElement("Person");
        RootElement->LinkEndChild(PersonElement);
        //设置Person元素的属性。

        PersonElement->SetAttribute("ID","1");
        //创建name元素、age元素并连接。

        TiXmlElement*NameElement = new TiXmlElement("name");
        TiXmlElement*AgeElement = new TiXmlElement("age");
        PersonElement->LinkEndChild(NameElement);
        PersonElement->LinkEndChild(AgeElement);
        //设置name元素和age元素的内容并连接。

        TiXmlText*NameContent = new TiXmlText("周星星");
        TiXmlText*AgeContent = new TiXmlText("22");
        NameElement->LinkEndChild(NameContent);
        AgeElement->LinkEndChild(AgeContent);
        CStringappPath =GetAppPath();
        stringseperator = "\\";
        stringfullPath =appPath.GetBuffer(0) +seperator+szFileName;
        myDocument->SaveFile(fullPath.c_str());//保存到文件

    }
    catch(string& e)
    {
        returnfalse;
    }
    returntrue;
}

boolReadXmlFile(string&szFileName)
{//读取Xml文件，并遍历

    try
    {
        CStringappPath =GetAppPath();
        stringseperator = "\\";
        stringfullPath =appPath.GetBuffer(0) +seperator+szFileName;
        //创建一个XML的文档对象。

        TiXmlDocument*myDocument = new TiXmlDocument(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()
{
    stringfileName = "info.xml";
    CreateXmlFile(fileName);
    ReadXmlFile(fileName);
}