全面的总结一下TinyXML操作XML文件的过程,TinyXML中的类与XML文件结构成一一对应关系。
Lxr
2013-09-12
1 TinyXML与XML的对应
1.1XML文件结构
- <spanstyle="font-size:14px;"><?xmlversion="1.0"encoding="gb2312"standalone="yes"?>
- Root>
- <!-注:端口信息的父标记只能为“ports”->
- portsportname="COM1"brate="9600"data="8"odd_even_check_bit="0"stop_bit="0"></portportname="COM2"brate="9600"data="8"odd_even_check_bit="0"stop_bit="0"portname="COM3"brate="9600"data="8"odd_even_check_bit="0"stop_bit="0" <!-........- <!-注:设备驱动信息的父标记只能为“drivers”-driversdrivername="stm100"varname="i"address="0"value="10"varvarname="u"address="1"value="10"varname="r"address="2"value="50"driver <!-注:设备信息的父标记只能为"devs"-devsdevname="sta1"adress="1"cname="COM1"driver="stm100"devdevname="sta1"adress="2"cname="COM1"driver="stm100"devname="sta1"adress="3"cname="COM2"driver="stm100"devname="sta1"adress="4"cname="COM3"driver="stm100" <!-........-span>
(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>。以此类推。
元素之间可以多层嵌套,在内存的元素为外层元素的子元素。
@H_472_502@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文件的读取。
@H_472_502@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的基本方法。
@H_472_502@II获取XML的根元素对于元素来说,对其操作的类为TiXmlElement。
TiXmlElement *pRootElement; pRootElement = pXmlDoc->RootElement(); if ( !pRootElement ) { return false; } |
对于以上XML文件,如果操作成功,则pRootElement指向根元素以起始标记为<Root>的元素,用pRootElement->Value();方法可获得根元素的起始标记。
@H_472_502@III获取根元素下的子元素 TiXmlElement *pRootChild; pRootChild = pRootElement->FirstChildElement(); if( ! pRootChild ) { return false; } |
用指向当前元素的指针使用方法FirstChildElement();就可以获取当前元素下的子元素。对于以上XML文件,若方法操作成功,则pRootChild指向以<Ports>为起始标记的这一个元素。
@H_472_502@IIII获取同层次的下一个元素 pRootChild = pRootChild-> NextSiblingElement(); |
使用NextSiblingElement();方法就可以获取跟pRootChild处于同层次下的下一个元素。对于以上XML文件,若此方法操作成功,则此时pRootChild指向以起始标记为<drivers>的元素。如果下一个没有则pRootChild为空。
@H_472_502@IIIII读取元素的属性、文本以以下XML元素为例:
<var |
name="i" address="0" value="10"> |
Text |
</var> |
元素起始标记名 |
文本 |
元素结束标记名 |
如在以上XML文件中,此元素对于根元素来说处于XML文本中的第三层子元素。假设元素指针pRootCCChild指向这一个元素
(1)读元素起始标记
用指向当前元素的指针使用Value();方法即可访问。如pRootCCChild->Value();代表值”var”。
(2)读元素属性
,操作中元素的属性用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)
操作元素文本的类是TiXmlElement。利用方法GetText()即可获得文本内容。
就这样就可以清晰地读出一个文件了。可以针对性的编写一个读XML文件一行的函数(因为所有的XML文件的每一行都可以看成为“起始标记、属性、文本、结束标记”组成的)。也可以针对同一层元素写一个遍历函数(只需在操作过后使用Next*)。
2TinyXML读XML文件函数例子
函数都有特殊用途,特殊用途部分可不参考。
2.1读XML一行属性的函数
可灵活扩展,将Text也读出来。