tinyXML读取xml文件的方法

全面的总结一下TinyXML操作XML文件的过程，TinyXML中的类与XML文件结构成一一对应关系。

Lxr

2013-09-12

1 TinyXML与XML的对应

1.1XML文件结构

[html]  view plain copy print ?

1. <span style="font-size:14px;"><?xml version="1.0" encoding="gb2312" standalone="yes" ?>  
2. <Root>  
3.   
4.   
5.     <!- 注：端口信息的父标记只能为“ports” ->  
6.     <ports>  
7.         <port name="COM1" brate="9600"  data="8" odd_even_check_bit ="0" stop_bit="0">    </port>  
8.         <port name="COM2" brate="9600"  data="8" odd_even_check_bit ="0" stop_bit="0">    </port>  
9.         <port name="COM3" brate="9600"  data="8" odd_even_check_bit ="0" stop_bit="0">    </port>  
10.         <!- ........->  
11.     </ports>  
12.   
13.     <!- 注：设备驱动信息的父标记只能为“drivers”->  
14.     <drivers>  
15.         <driver name="stm100">  
16.             <var name="i" address="0" value="10"> </var>  
17.             <var name="u" address="1" value="10"> </var>  
18.             <var name="r" address="2" value="50"> </var>  
19.         </driver>  
20.     </drivers>  
21.   
22.   
23.     <!- 注：设备信息的父标记只能为"devs"->  
24.     <devs>  
25.         <dev name="sta1" adress="1" cname="COM1" driver="stm100"> </dev>   
26.         <dev name="sta1" adress="2" cname="COM1" driver="stm100"> </dev>   
27.         <dev name="sta1" adress="3" cname="COM2" driver="stm100"> </dev>   
28.         <dev name="sta1" adress="4" cname="COM3" driver="stm100"> </dev>   
29.         <!- ........->  
30.     </devs>  
31.   
32. </Root></span>  

I XML文件嵌套结构

(1)XML声明

[1]为XML文件声明，指明XML的版本为1.0，支持gb2312（可在XML中写中文），独立格式。声明主要是用来表面当前XML文件所遵循的XML标准。

(2)根元素

[2]为XML的第一个根元素起始标记，与声明处于同一层次。在此XML文件中，其余元素都是[2]<Root>的子元素，结束标志在[32].

(3)注释结构

[5]为XML注释的写法：<!-注释内容->

(4)子元素

[6]、[14]、[24]为以<Root>位起始标记的根元素下的第一层子元素起始标记，元素结束标记分别对应在[11]、[20]、[30]。

[7] ~[9]为以<port>位起始标记的元素的子元素，也是以<Root>为起始标记的元素的第二层子元素。结束标记为</ports>。以此类推。

元素之间可以多层嵌套，在内存的元素为外层元素的子元素。

II 元素结构

元素时构成XML文件的主要内容，用TinyXML读取XML文件时主要是对各元素的嵌套关系和对元素结构的读取。捡以上XML文件[16]元素来说明它具有的如下结构。

<var	name="i"  address="0" value="10">	Text	</var>
元素起始标记名	起始标记属性	文本	元素结束标记名

文本部分在以上的XML中没有书写。属性、文本都是可以缺省的。

1.2TinyXML方法与XML结构的对应

在TinyXML眼里，对于已经存在的一个XML文件（TinyXMLY也可以创建任意内容的XML文件），可以分为5种情况来描述完对XML文件的读取。

I 载入XML文件

对于，TinyXML，对应XML整个文件的类为TiXmlDocument。

TiXmlDocument *pXmlDoc = NULL; pXmlDoc        = new TiXmlDocument(); if( !pXmlDoc ) {      return false; } //加载目标XML文件 pXmlDoc->LoadFile( filename ); …… if( pXmlDoc ) {          delete  pXmlDoc; }

对于以上XML文件，LoadFile方法载入已经存在的XML文件，同时这段代码也展示了使用new-delete的基本方法。

II 获取XML的根元素

对于XML元素来说，TinyXML对其操作的类为TiXmlElement。

TiXmlElement *pRootElement; pRootElement       = pXmlDoc->RootElement(); if ( !pRootElement ) {              return false; }

对于以上XML文件，如果操作成功，则pRootElement指向根元素以起始标记为<Root>的元素,用pRootElement->Value();方法可获得根元素的起始标记。

III 获取根元素下的子元素

TiXmlElement *pRootChild; pRootChild        =  pRootElement->FirstChildElement(); if( ! pRootChild ) {          return false; }

用指向当前元素的指针使用方法FirstChildElement();就可以获取当前元素下的子元素。对于以上XML文件，若方法操作成功，则pRootChild指向以<Ports>为起始标记的这一个元素。

IIII 获取同层次的下一个元素

pRootChild       = pRootChild-> NextSiblingElement();

使用NextSiblingElement();方法就可以获取跟pRootChild处于同层次下的下一个元素。对于以上XML文件，若此方法操作成功，则此时pRootChild指向以起始标记为<drivers>的元素。如果下一个没有则pRootChild为空。

IIIII 读取元素的属性、文本

以以下XML元素为例：

<var	name="i"  address="0" value="10">	Text	</var>
元素起始标记名	起始标记属性	文本	元素结束标记名

如在以上XML文件中，此元素对于根元素来说处于XML文本中的第三层子元素。假设元素指针pRootCCChild指向这一个元素

(1)读元素起始标记

用指向当前元素的指针使用Value();方法即可访问。如pRootCCChild->Value();代表值”var”。

(2)读元素属性

对于TinyXML，操作XML中元素的属性用TiXmlAttribute类。

TiXmlAttribute *pAttribute; //取当前行的第一个属性 pAttribute         = XmlCurrentLine->FirstAttribute(); if ( !pAttribute ) {         //… } … //获取此元素的下一个属性 pAttribute        = pAttribute->Next();

• pAttribute       = XmlCurrentLine->FirstAttribute();语句让 pAttribute指向以上元素的一个属性：name="i"（属性是name-value对的形式）。
• 用pAttribute->Name();方法可以获取到name,用pAttribute->Value();方法获取到i。
• pAttribute        =pAttribute->Next();让pAttribute指向“address="0"”属性。如果往后不在有属性则pAttribute为空。

(3)对元素文本内容（Text）

操作元素文本的TinyXML类是TiXmlElement。利用方法GetText()即可获得文本内容。

就这样就可以清晰地读出一个文件了。可以针对性的编写一个读XML文件一行的函数（因为所有的XML文件的每一行都可以看成为“起始标记、属性、文本、结束标记”组成的）。也可以针对同一层元素写一个遍历函数（只需在操作过后使用Next*）。

2TinyXML读XML文件函数例子

函数都有特殊用途，特殊用途部分可不参考。

2.1 读XML一行属性的函数

可灵活扩展，将Text也读出来。

[cpp]  view plain copy print ?

1. <span style="font-size:14px;">bool read_xml_oneline_attribute( TiXmlElement *XmlCurrentLine, xml_line &one_line )  
2. {  
3.        //当前行为空  
4.        if ( !XmlCurrentLine )  
5.        {  
6.               return false;  
7.        }  
8.   
9.   
10.   
11.        //将XML文件当前行的起始标记保存  
12.        strcpy( one_line.one_flag, XmlCurrentLine->Value() );  
13.   
14.   
15.        //定义属性下标、XML属性对象指针  
16.        int m;  
17.        TiXmlAttribute *pAttribute;   
18.        m                = 0;  
19.        pAttribute       = NULL;  
20.          
21.           
22.        //取当前行的第一个属性  
23.        pAttribute = XmlCurrentLine->FirstAttribute();  
24.        if ( !pAttribute )  
25.        {  
26.                strcpy( one_line.attribute[m], EMPTY_FLAG );  
27.            return true;  
28.        }   
29.        else  
30.        {  
31.               while ( pAttribute )  
32.               {  
33.                   //防止数组溢出  
34.                   if ( m < LINE_ATT_SIZE )  
35.                   {  
36.                   //保存当前的属性到变量  
37.                   strcpy( one_line.attribute[m], pAttribute->Value() );  
38.   
39.                   //保存下一个  
40.                   ++m;  
41.                   }  
42.                     
43.               //下一属性  
44.               pAttribute        = pAttribute->Next();  
45.               }  
46.           //让最后一个元素为空  
47.           strcpy( one_line.attribute[m], EMPTY_FLAG );  
48.        }  
49.   
50.        return true;  
51. }</span>  

2.2 遍历XML同层次元素函数

[cpp]  view plain copy print ?

1. <span style="font-size:14px;">bool read_same_element( TiXmlElement *XmlCurrentLine, short int &index, const short int index_size,  xml_line one_line[] )  
2. {  
3.         index = 0;  
4.     while ( XmlCurrentLine )  
5.     {  
6.             if ( index < index_size )  
7.         {  
8.             //读当前子元素的标记和属性  
9.             read_xml_oneline_attribute( XmlCurrentLine, one_line[index] );  
10.         }  
11.   
12.         //下一行  
13.         XmlCurrentLine        = XmlCurrentLine->NextSiblingElement();  
14.         if ( XmlCurrentLine )  
15.         {  
16.                 ++index;  
17.         }  
18.     }  
19.        return true;  
20. }</span>  

 对于函数的参数函数的具体内容皆可不参考。