TinyXml快速入门（一）

作者：朱金灿
来源：http://blog.youkuaiyun.com/clever101

      对于xml文件，目前我的工作只是集中在配置文件和作为简单的信息文件来用，因此我不太喜欢使用msxml这种重量级的xml解析器，特别是使用 msxml解析xml涉及到复杂的com类型转换，更是令人感觉繁琐。因此对于简单的xml文件的解析，我更愿意使用开源的TinyXml。

      首先介绍一下TinyXml吧。TinyXML是目前非常流行的一款基于DOM模型的XML解析器，简单易用且小巧玲珑，非常适合存储简单数据，配置文件，对象序列化等数据量不是很大的操作，其主页是：http://www.grinninglizard.com/tinyxml/ ，目前最新版本是2.5.3 版本。

TinyXml网上的教程很多，但是我觉得写得都不怎样（感觉就是看完之后就 没学会）。没办法，只得自己整理一篇适合自己的，至于适不适合别人，就见仁见智了。我感觉xml文件本质就是小型的数据库，换个角度来说就是，你对数据库 有什么操作你对xml文件就应能实现什么操作。一般而言，对数据库的操作包括以下几种：新建数据库、查询数据库、修改数据库和删除数据库。那么对应xml 文件就是新建xml文件、查询xml文件的指定节点的值，修改xml文件中节点的值和删除xml文件中节点的值。

       首先我们认识一下xml文件有哪几种形式。下面我列出一些常用的xml文件的形式：

view plain

1. example1.xml:  
2. <? xml   version = "1.0"   ?>   
3. < Hello > World </ Hello >   
4. example2.xml:  
5. <? xml   version = "1.0"   ?>   
6. < poetry >   
7.        < verse >   
8.                Alas  
9.                  Great World  
10.                        Alas (again)  
11.        </ verse >   
12. </ poetry >   
13. example3.xml:  
14. <? xml   version = "1.0"   ?>   
15. < shapes >   
16.        < circle   name = "int-based"   x = "20"   y = "30"   r = "50"   />   
17.        < point   name = "float-based"   x = "3.5"   y = "52.1"   />   
18. </ shapes >   
19. example4.xml:  
20. <? xml   version = "1.0"   ?>   
21. < MyApp >   
22.     < Messages >   
23.         < Welcome > Welcome to MyApp </ Welcome >   
24.         < Farewell > Thank you for using MyApp </ Farewell >   
25.     </ Messages >   
26.     < Windows >   
27.         < Window   name = "MainFrame"   x = "5"   y = "15"   w = "400"   h = "250"   />   
28.     </ Windows >   
29.     < Connection   ip = "192.168.0.1"   timeout = "123.456000"   />   
30. </ MyApp >   

      上面的例子摘自《TinyXML Tutorial 中文指南》。上面有四个例子，你看到了xml文件的几种表现形式？我看到了本质来说不过是两种表现形式：属性值值在尖括号内，如<Window name="MainFrame" x="5" y="15" w="400" h="250" />和文本在尖括号外，如<Welcome>Welcome to MyApp</Welcome>，具体如下图：

     鉴于example4.xml比较复杂，下面我将以此为例介绍tinyxml的使用。

     Tinyxml使用了两种编译选择：使用标准C的char *类型或者使用STL中的std::string,其中使用预处理器TIXML_USE_STL进行控制，即添加了TIXML_USE_STL为使用 std::string的。鉴于STL的广泛使用以及其强大功能，下面我以使用std::string的tinyxml说明。

首先使用VS 2005打开tinyxmlSTL.dsp的工程文件，将其编译成一个静态库，debug版本为：tinyxmld_STL.lib，然后开始测试 tinyxml库。我的测试计划是这样的：首先使用tinyxml库创建example4.xml，然后将其读出来，然后查询指定节点的属性或文本，再修 改example4.xml（修改其中的一些节点值和删除其中一个节点，增加一个节点），然后再读出来以判断是否修改成功。具体是在VS 2005上新建一个控制台工程：Test，注意使用多字节字符集进行编译，同时添加。首先是创建xml文件的代码：

    

view plain

1. /*!  
2. *  /brief 创建xml文件。  
3. *  
4. *  /param XmlFile xml文件全路径。  
5. *  /return 是否成功。true为成功，false表示失败。  
6. */   
7. bool  CreateXml(std::string XmlFile)  
8. {  
9.     // 定义一个TiXmlDocument类指针   
10.     TiXmlDocument *pDoc = new  TiXmlDocument;  
11.     if  (NULL==pDoc)  
12.     {  
13.         return   false ;  
14.     }  
15.     TiXmlDeclaration *pDeclaration = new  TiXmlDeclaration(_T( "1.0" ),_T( "" ),_T( "" ));  
16.     if  (NULL==pDeclaration)  
17.     {  
18.         return   false ;  
19.     }  
20.     pDoc->LinkEndChild(pDeclaration);  
21.     // 生成一个根节点：MyApp   
22.     TiXmlElement *pRootEle = new  TiXmlElement(_T( "MyApp" ));  
23.     if  (NULL==pRootEle)  
24.     {  
25.         return   false ;  
26.     }  
27.     pDoc->LinkEndChild(pRootEle);  
28.     // 生成子节点：Messages   
29.     TiXmlElement *pMsg = new  TiXmlElement(_T( "Messages" ));  
30.     if  (NULL==pMsg)  
31.     {  
32.         return   false ;  
33.     }  
34.     pRootEle->LinkEndChild(pMsg);  
35.     // 生成子节点：Welcome   
36.     TiXmlElement *pWelcome = new  TiXmlElement(_T( "Welcome" ));  
37.     if  (NULL==pWelcome)  
38.     {  
39.         return   false ;  
40.     }  
41.     pMsg->LinkEndChild(pWelcome);  
42.     // 设置Welcome节点的值   
43.     std::string strValue = _T("Welcome to MyApp" );  
44.     TiXmlText *pWelcomeValue = new  TiXmlText(strValue);  
45.     pWelcome->LinkEndChild(pWelcomeValue);  
46.     // 生成子节点：Farewell   
47.     TiXmlElement *pFarewell = new  TiXmlElement(_T( "Farewell" ));  
48.     if  (NULL==pFarewell)  
49.     {  
50.         return   false ;  
51.     }  
52.     pMsg->LinkEndChild(pFarewell);  
53.     // 设置Farewell节点的值   
54.     strValue = _T("Thank you for using MyApp" );  
55.     TiXmlText *pFarewellValue = new  TiXmlText(strValue);  
56.     pFarewell->LinkEndChild(pFarewellValue);  
57.     // 生成子节点：Windows   
58.     TiXmlElement *pWindows = new  TiXmlElement(_T( "Windows" ));  
59.     if  (NULL==pWindows)  
60.     {  
61.         return   false ;  
62.     }  
63.     pRootEle->LinkEndChild(pWindows);  
64.     // 生成子节点：Window   
65.     TiXmlElement *pWindow = new  TiXmlElement(_T( "Window" ));  
66.     if  (NULL==pWindow)  
67.     {  
68.         return   false ;  
69.     }  
70.     pWindows->LinkEndChild(pWindow);  
71.     // 设置节点Window的值   
72.     pWindow->SetAttribute(_T("name" ),_T( "MainFrame" ));  
73.     pWindow->SetAttribute(_T("x" ),_T( "5" ));  
74.     pWindow->SetAttribute(_T("y" ),_T( "15" ));  
75.     pWindow->SetAttribute(_T("w" ),_T( "400" ));  
76.     pWindow->SetAttribute(_T("h" ),_T( "250" ));  
77.     // 生成子节点：Window   
78.     TiXmlElement *pConnection  = new  TiXmlElement(_T( "Connection" ));  
79.     if  (NULL==pConnection)  
80.     {  
81.         return   false ;  
82.     }  
83.     pRootEle->LinkEndChild(pConnection);  
84.     // 设置节点Connection的值   
85.     pConnection->SetAttribute(_T("ip" ),_T( "192.168.0.1" ));  
86.     pConnection->SetAttribute(_T("timeout" ),_T( "123.456000" ));  
87.     pDoc->SaveFile(XmlFile);  
88.     return   true ;  
89. }   

       不知你注意到上面的规律没有？首先父节点连接字节点使用函数LinkEndChild，使用方法是：pParentNode-> LinkEndChild(pChild);其次设置类似这种结构<Window name="MainFrame" x="5" y="15" w="400" h="250" />采用SetAttribute函数，这个函数有两个参数，前一个参数表示键，后一个参数表示键值，设 置<Farewell>Thank you for using MyApp</Farewell>这种结构采用TiXmlText类，使用LinkEndChild函数进行连结。

      上面是创建xml文件的代码，下面介绍读取xml文件的代码。打印整个xml文件的代码很简单，代码如下：

view plain

1. /*!  
2. *  /brief 打印xml文件。  
3. *  
4. *  /param XmlFile xml文件全路径。  
5. *  /return 是否成功。true为成功，false表示失败。  
6. */   
7. bool  PaintXml(std::string XmlFile)  
8. {  
9.     // 定义一个TiXmlDocument类指针   
10.     TiXmlDocument *pDoc = new  TiXmlDocument();  
11.     if  (NULL==pDoc)  
12.     {  
13.         return   false ;  
14.     }  
15.     pDoc->LoadFile(XmlFile);  
16.     pDoc->Print();  
17.     return   true ;  
18. }  

   下次介绍使用tinyxml库对xml文件进行查询指定节点、删除指定节点、修改指定节点和增加节点的用法。

参考文献：

1.《TinyXML入门教程 》

2. 《tinyxml 使用笔记与总结 》

3. 《TinyXML Tutorial 中文指南 》