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：表示一个元素的属性
下面是一个简单的例子：



   TinyXml How To
   20
   Some words…

整个文档，对应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, and DECLARATION
7、TinyXml的在线文档和主页：

8、常用操作详解：
#include "tinyxml.h"
#include
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;
       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 = 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("Failed to load file /"%s/"/n", argv[1]);
        }
     return 0;
   }

9、引例

#include
#include"tinyxml.h"
#include"tinystr.h"
#include
#include
#include
usingnamespacestd;

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

    TCHAR modulePath[MAX_PATH];
    GetModuleFileName(NULL, modulePath, MAX_PATH);
    CString strModulePath(modulePath);
    strModulePath = strModulePath.Left(strModulePath.ReverseFind(_T('\\')));
    return strModulePath;
}

bool CreateXmlFile(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);
        CString appPath = GetAppPath();
        string seperator ="\\";
        string fullPath = appPath.GetBuffer(0)+seperator+szFileName;
        myDocument->SaveFile(fullPath.c_str());//保存到文件

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

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

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

        TiXmlDocument *myDocument =new TiXmlDocument(fullPath.c_str());
        myDocument->LoadFile();
        //获得根元素，即Persons。

        TiXmlElement *RootElement = myDocument->RootElement();
        //输出根元素名称，即输出Persons。

        cout<< RootElement->Value()<         //获得第一个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()<         cout<< AgeElement->FirstChild()->Value()<         cout<< IDAttribute->Value()<     }
    catch(string& e)
    {
        returnfalse;
    }
    returntrue;
}
int main()
{
    string fileName ="info.xml";
    CreateXmlFile(fileName);
    ReadXmlFile(fileName);
}