TiXml使用详解

本文用一个详细的例子说明了TiXml的使用方法。如写、查找、插入、替换、加载、遍历等常见操作。

首先简单介绍一下TinyXml，要看详细的在网上搜搜了^_^:

TinyXML是一个简单小巧，可以很容易集成到其它程序中的C++ XML解析器。简单地说，TinyXML解析一个XML文档并由此生成一个可读可修改可保存的文档对象模型（DOM）。TinyXML使用文档对象模型（DOM），这意味着XML数据被解析成一个可被浏览和操作的C++对象，然后它可以被写到磁盘或者另一个输出流中。你也可以把C++对象构造成一个XML文档然后把它写到磁盘或者另一个输出流中。

1、TinyXml源代码只有4个cpp文件和2个头文件。

2、首先要理解TinyXml中的各个基本类型之间的关系，看看这个继承图大家就会很明白了！

可以看到TinyXml中的注释comment ，声明declaration，元素element，文本等都是节点Node的子类，也就是说可以把XMl文件中的各个元素当做节点来处理。Node类型也有到各个子类之间的转换方法，如ToElement（）转换成元素，ToDocument转换成文档等。

因此可以吧TiXmlNode作为TinyXml的基本数据类型来操作，这样转化到其他类型也比较方便！

3、类之间的关系
TinyXml实现的是DOM访问模型，因此提供了一系列的类对应XML文件中的各个节点。主要类间的关系如下：
TiXmlBase：其他类的基类，是个抽象类
TiXmlNode：表示一个节点，包含节点的一般方法，如访问子节点、兄弟节点、编辑自身、编辑子节点
TiXmlDocument：表示整个XML文档，不对应其中某个特定的节点。
TiXmlElement：表示元素节点，可以包含子节点和TiXmlAttribute
TiXmlComment：表示注释
TiXmlDeclaration：表示声明
TiXmlText：表示文本节点
TiXmlUnknown：表示未知节点，通常是出错了
TiXmlAttribute：表示一个元素的属性
下面是一个简单的例子：
<?xml version="1.0" encoding="utf-8" ?>
<!-This is only a sample-->
<book>
<name>TinyXml How To</name>
<price unit=”RMB”>20</price>
<description>Some words…</description>
</ book >
整个文档，对应TiXmlDocument
book,name,price, description，都对应TiXmlElement
第一行对应一个TiXmlDeclaration
第二行对应一个TiXmlComment
“TinyXml How To”对应一个TiXmlText
unit则是price的一个TiXmlAttribute
这些类与XML文件中的相应元素都有很好的对应关系，因此相信参照TinyXml的文档，可以很容易的掌握各个方法的使用。
2. 需要注意的问题
各类之间的转换
由于各个节点类都从TiXmlNode继承，在使用时常常需要将TiXmlNode*类型的指针转换为其派生类的指针，在进行这种转换时，应该首先使用由TiXmlNode类提供的一系列转换函数，如ToElement(void)，而不是c++的dynamic_cast。
检查返回值
由于TinyXml是一个非校验的解析器，因此当解析一个文件时，很可能文件并不包含我们预期的某个节点，在这种情况下，TinyXml将返回空指针。因此，必须要对返回值进行检查，否则将很容易出现内存访问的错误。
如何重头建立一个XML文件
先建立一个TiXmlDocument对象，然后，载入某个模板，或者直接插入一个节点作为根节点，接着就可以像打开一个已有的XML文件那样对它进行操作了。

4、要理解TinyXml中的每个节点都可能是另一个节点的父节点这个很重要，因此遍历TinyXml文档要用递归的方法。每个节点都可能有属性，文本什么的！

5、每个type of TiXmlNode节点的值'value'对应如下 ：

Document: filename of the xml file

Element: name of the element

Comment: the comment text

Unknown: the tag contents

Text: the text string

6、TinyXml中Node的类型types是一个枚举类型，其成员如下：
 

DOCUMENT, ELEMENT, COMMENT, UNKNOWN, TEXT, and DECLARATION
7、TinyXml的在线文档和主页：
http://www.grinninglizard.com/tinyxmldocs/index.html
8、常用操作详解：
#include "tinyxml.h"
#include <iostream>
using namespace std;

TiXmlDocument *pDoc =NULL;
void write_xml( )
{

TiXmlDocument doc;
TiXmlDeclaration * decl = new TiXmlDeclaration( "1.0", "", "" );
doc.LinkEndChild( decl );

TiXmlElement * element1 = new TiXmlElement( "AMULE_ToDL" );//创建元素element1
element1->SetAttribute("num",5);
doc.LinkEndChild( element1 );

TiXmlElement * element11 = new TiXmlElement( "name" );
element11->SetAttribute("name","GongFong.rmvb");//创建属性
element1->LinkEndChild( element11 );//链接element11为element1的子节点（子元素）

TiXmlElement * element2 = new TiXmlElement( "BT_ToDL" );
element2->SetAttribute("num",10);

  doc.LinkEndChild(element2);

doc.SaveFile( "1.xml" );
}

void dump_to_stdout( TiXmlNode* pParent )//Tixml主页上给的一个遍历方法(递归调用)
{
if ( !pParent ) return;

TiXmlNode* pChild;
TiXmlText* pText;
int t = pParent->Type();
printf( "type %d/n", t);
int num;

switch ( t )
{
case TiXmlNode::DOCUMENT:
    printf( "Document" );
  break;

case TiXmlNode::ELEMENT:
printf( "Element [%s]", pParent->Value() );
      num=dump_attribs_to_stdout(pParent->ToElement(), indent+1);
switch(num)
{
case 0: printf( " (No attributes)"); break;
case 1: printf( "%s1 attribute", getIndentAlt(indent)); break;
default: printf( "%s%d attributes", getIndentAlt(indent), num); break;
}
break;

case TiXmlNode::COMMENT:
    printf( "Comment: [%s]", pParent->Value());
break;

case TiXmlNode::UNKNOWN:
printf( "Unknown" );
break;

case TiXmlNode::TEXT:
  pText = pParent->ToText();
printf( "Text: [%s]", pText->Value() );
break;

case TiXmlNode::DECLARATION:
printf( "Declaration" );
break;
default:
break;
}
printf( "/n" );
for ( pChild = pParent->FirstChild(); pChild != 0; pChild = pChild->NextSibling())
{
dump_to_stdout( pChild );
}
}
void search(TiXmlNode* pParent)//遍历时候，把每个节点都是做一个父节点，即假定其都有子节点ChildNode
{
if ( !pParent ) return;

TiXmlNode* pChild= NULL;
int t = pParent->Type();//获取此节点的类型

if (TiXmlNode::ELEMENT == t && (strcmp("Welcome",pParent->Value()) == 0))//搜索元素值为"Welcome"的节点
{
printf("value %s/n",pParent->Value());//打印值
pParent->SetValue("re-write");//改变其值
pParent->ToElement()->SetAttribute("hello",20);//设置其属性

TiXmlElement * element1 = new TiXmlElement( "AMULE_ToDL" );//添加一个节点
element1->SetAttribute("num",5);
pParent->LinkEndChild(element1);

pDoc->SaveFile(); //保存文件
}
printf( "/n" );
for ( pChild = pParent->FirstChild(); pChild != 0; pChild = pChild->NextSibling())
{
search(pChild);
}
}

int main(int argc, char* argv[])
{

TiXmlDocument doc(argv[1]);
bool loadOkay = doc.LoadFile();
if (loadOkay)
{
pDoc = &doc;
printf("/n%s:/n", argv[1]);
search(&doc); //把TiXmlDocument类型的值复制给一个TiXmlNode类型
}
else
{
printf("Failed to load file /"%s/"/n", argv[1]);
}
return 0;
}

9、引例

#include <iostream>
#include "tinyxml.h"
#include "tinystr.h"
#include <string>
#include <windows.h>
#include <atlstr.h>
using namespace std;

CString GetAppPath()
{//获取应用程序根目录

TCHAR modulePath[MAX_PATH];
GetModuleFileName(NULL, modulePath, MAX_PATH);
CString strModulePath(modulePath);
strModulePath = strModulePath.Left(strModulePath.ReverseFind(_T('\\')));
return strModulePath;
}

bool CreateXmlFile(string& szFileName)
{//创建xml文件,szFilePath为文件保存的路径,若创建成功返回true,否则false

try
{
//创建一个XML的文档对象。

TiXmlDocument *myDocument = new TiXmlDocument();
//创建一个根元素并连接。

TiXmlElement *RootElement = new TiXmlElement("Persons");
myDocument->LinkEndChild(RootElement);
//创建一个Person元素并连接。

TiXmlElement *PersonElement = new TiXmlElement("Person");
RootElement->LinkEndChild(PersonElement);
//设置Person元素的属性。

PersonElement->SetAttribute("ID", "1");
//创建name元素、age元素并连接。

TiXmlElement *NameElement = new TiXmlElement("name");
TiXmlElement *AgeElement = new TiXmlElement("age");
PersonElement->LinkEndChild(NameElement);
PersonElement->LinkEndChild(AgeElement);
//设置name元素和age元素的内容并连接。

TiXmlText *NameContent = new TiXmlText("周星星");
TiXmlText *AgeContent = new TiXmlText("22");
NameElement->LinkEndChild(NameContent);
AgeElement->LinkEndChild(AgeContent);
CString appPath = GetAppPath();
string seperator = "\\";
string fullPath = appPath.GetBuffer(0) +seperator+szFileName;
myDocument->SaveFile(fullPath.c_str());//保存到文件

}
catch (string& e)
{
return false;
}
return true;
}

bool ReadXmlFile(string& szFileName)
{//读取Xml文件，并遍历

try
{
CString appPath = GetAppPath();
string seperator = "\\";
string fullPath = appPath.GetBuffer(0) +seperator+szFileName;
//创建一个XML的文档对象。

TiXmlDocument *myDocument = new TiXmlDocument(fullPath.c_str());
myDocument->LoadFile();
//获得根元素，即Persons。

TiXmlElement *RootElement = myDocument->RootElement();
//输出根元素名称，即输出Persons。

cout << RootElement->Value() << endl;
//获得第一个Person节点。

TiXmlElement *FirstPerson = RootElement->FirstChildElement();
//获得第一个Person的name节点和age节点和ID属性。

TiXmlElement *NameElement = FirstPerson->FirstChildElement();
TiXmlElement *AgeElement = NameElement->NextSiblingElement();
TiXmlAttribute *IDAttribute = FirstPerson->FirstAttribute();
//输出第一个Person的name内容，即周星星；age内容，即；ID属性，即。

cout << NameElement->FirstChild()->Value() << endl;
cout << AgeElement->FirstChild()->Value() << endl;
cout << IDAttribute->Value()<< endl;
}
catch (string& e)
{
return false;
}
return true;
}
int main()
{
string fileName = "info.xml";
CreateXmlFile(fileName);
ReadXmlFile(fileName);
}