tinyXML读取xml文件的方法

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

Lxr

2013-09-12

1 TinyXML与XML的对应

1.1XML文件结构

 <span style="font-size:14px;">xml version="1.0" encoding="gb2312" standalone="yes" ?>
 <Root>


     >
     <ports>
         <port name="COM1" brate="9600"  data="8" odd_even_check_bit ="0" stop_bit="0">    port>
         <port name="COM2" brate="9600"  data="8" odd_even_check_bit ="0" stop_bit="0">    port>
         <port name="COM3" brate="9600"  data="8" odd_even_check_bit ="0" stop_bit="0">    port>
         >
     ports>

     >
     <drivers>
         <driver name="stm100">
             <var name="i" address="0" value="10"> var>
             <var name="u" address="1" value="10"> var>
             <var name="r" address="2" value="50"> var>
         driver>
     drivers>


     >
     <devs>
         <dev name="sta1" adress="1" cname="COM1" driver="stm100"> dev>
         <dev name="sta1" adress="2" cname="COM1" driver="stm100"> dev>
         <dev name="sta1" adress="3" cname="COM2" driver="stm100"> dev>
         <dev name="sta1" adress="4" cname="COM3" driver="stm100"> dev>
         >
     devs>

 Root>span>

I XML文件嵌套结构

(1)XML声明

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

(2)根元素

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

(3)注释结构

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

(4)子元素

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

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

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

II 元素结构

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

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

文本部分在以上的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指向根元素以起始标记为的元素,用pRootElement->Value();方法可获得根元素的起始标记。

III 获取根元素下的子元素

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

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

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

pRootChild       = pRootChild-> NextSiblingElement();

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

IIIII 读取元素的属性、文本

以以下XML元素为例：

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

如在以上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也读出来。

 "font-size:14px;">bool read_xml_oneline_attribute( TiXmlElement *XmlCurrentLine, xml_line &one_line )
 {
        //当前行为空
        if ( !XmlCurrentLine )
        {
               return false;
        }



        //将XML文件当前行的起始标记保存
        strcpy( one_line.one_flag, XmlCurrentLine->Value() );


        //定义属性下标、XML属性对象指针
        int m;
        TiXmlAttribute *pAttribute;
        m                = 0;
        pAttribute       = NULL;


        //取当前行的第一个属性
        pAttribute = XmlCurrentLine->FirstAttribute();
        if ( !pAttribute )
        {
                strcpy( one_line.attribute[m], EMPTY_FLAG );
            return true;
        }
        else
        {
               while ( pAttribute )
               {
                   //防止数组溢出
                   if ( m < LINE_ATT_SIZE )
                   {
                   //保存当前的属性到变量
                   strcpy( one_line.attribute[m], pAttribute->Value() );

                   //保存下一个
                   ++m;
                   }

               //下一属性
               pAttribute        = pAttribute->Next();
               }
           //让最后一个元素为空
           strcpy( one_line.attribute[m], EMPTY_FLAG );
        }

        return true;
 }

2.2 遍历XML同层次元素函数

 "font-size:14px;">bool read_same_element( TiXmlElement *XmlCurrentLine, short int &index, const short int index_size,  xml_line one_line[] )
 {
         index = 0;
     while ( XmlCurrentLine )
     {
             if ( index < index_size )
         {
             //读当前子元素的标记和属性
             read_xml_oneline_attribute( XmlCurrentLine, one_line[index] );
         }

         //下一行
         XmlCurrentLine        = XmlCurrentLine->NextSiblingElement();
         if ( XmlCurrentLine )
         {
                 ++index;
         }
     }
        return true;
 }

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