全面的总结一下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” ->
	<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”->
	<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"->
	<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]<Root>的子元素，结束标志在[32].

(3)注释结构

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

(4)子元素

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

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

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

II 元素结构

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

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

1.2TinyXML方法与XML结构的对应

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

I 载入XML文件

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

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

II 获取XML的根元素

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

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

III 获取根元素下的子元素

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

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

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

IIIII 读取元素的属性、文本

以以下XML元素为例：

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

(1)读元素起始标记

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

(2)读元素属性

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

• 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也读出来。

<span style="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;
}</span>

2.2 遍历XML同层次元素函数

<span style="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;
}</span>

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

此次笔记记录完毕。