Visual C++ TinyXml快速入门（一）

xml文件本质就是小型的数据库，换个角度来说就是，你对数据库有什么操作你对xml文件就应能实现什么操作。一般而言，对数据库的操作包括以下几种：新建数据库、查询数据库、修改数据库和删除数据库。那么对应xml文件就是新建xml文件、查询xml文件的指定节点的值，修改xml文件中节点的值和删除xml文件中节点的值。

首先我们认识一下xml文件有哪几种形式。下面我列出一些常用的xml文件的形式：

example1.xml:
<?xml version="1.0" ?>
<Hello>World</Hello>

example2.xml:
<?xml version="1.0" ?>
<poetry>
       <verse>
               Alas
                 Great World
                       Alas (again)
       </verse>
</poetry>

example3.xml:
<?xml version="1.0" ?>
<shapes>
       <circle name="int-based" x="20" y="30" r="50" />
       <point name="float-based" x="3.5" y="52.1" />
</shapes>

example4.xml:
<?xml version="1.0" ?>
<MyApp>
    <Messages>
        <Welcome>Welcome to MyApp</Welcome>
        <Farewell>Thank you for using MyApp</Farewell>
    </Messages>
    <Windows>
        <Window name="MainFrame" x="5" y="15" w="400" h="250" />
    </Windows>
    <Connection ip="192.168.0.1" timeout="123.456000" />
</MyApp>

上面的例子摘自《TinyXML Tutorial 中文指南》。上面有四个例子，你看到了xml文件的几种表现形式？我看到了本质来说不过是两种表现形式：属性值值在尖括号内，如<Window name="MainFrame" x="5" y="15" w="400" h="250" />和文本在尖括号外，如<Welcome>Welcome to MyApp</Welcome>。

鉴于example4.xml比较复杂，下面我将以此为例介绍tinyxml的使用。

Tinyxml使用了两种编译选择：使用标准C的char *类型或者使用STL中的std::string,其中使用预处理器TIXML_USE_STL进行控制，即添加了TIXML_USE_STL为使用std::string的。鉴于STL的广泛使用以及其强大功能，下面我以使用std::string的tinyxml说明。

首先使用VS 2010打开tinyxmlSTL.dsp的工程文件，将其编译成一个静态库，debug版本为：tinyxmld_STL.lib，然后开始测试tinyxml库。我的测试计划是这样的：首先使用tinyxml库创建example4.xml，然后将其读出来，然后查询指定节点的属性或文本，再修改example4.xml（修改其中的一些节点值和删除其中一个节点，增加一个节点），然后再读出来以判断是否修改成功。具体是在VS 2010上新建一个控制台工程：Test，注意使用多字节字符集进行编译，同时添加。首先是创建xml文件的代码：

/*!
*  /brief 创建xml文件。
*
*  /param XmlFile xml文件全路径。
*  /return 是否成功。true为成功，false表示失败。
*/
bool CreateXml(std::string XmlFile)
{
// 定义一个TiXmlDocument类指针
TiXmlDocument *pDoc = new TiXmlDocument;
if (NULL==pDoc)
{
return false;
}
TiXmlDeclaration *pDeclaration = new TiXmlDeclaration(_T("1.0"),_T(""),_T(""));
if (NULL==pDeclaration)
{
return false;
}
pDoc->LinkEndChild(pDeclaration);
// 生成一个根节点：MyApp
TiXmlElement *pRootEle = new TiXmlElement(_T("MyApp"));
if (NULL==pRootEle)
{
return false;
}
pDoc->LinkEndChild(pRootEle);
// 生成子节点：Messages
TiXmlElement *pMsg = new TiXmlElement(_T("Messages"));
if (NULL==pMsg)
{
return false;
}
pRootEle->LinkEndChild(pMsg);
// 生成子节点：Welcome
TiXmlElement *pWelcome = new TiXmlElement(_T("Welcome"));
if (NULL==pWelcome)
{
return false;
}
pMsg->LinkEndChild(pWelcome);
// 设置Welcome节点的值
std::string strValue = _T("Welcome to MyApp");
TiXmlText *pWelcomeValue = new TiXmlText(strValue);
pWelcome->LinkEndChild(pWelcomeValue);
// 生成子节点：Farewell
TiXmlElement *pFarewell = new TiXmlElement(_T("Farewell"));
if (NULL==pFarewell)
{
return false;
}
pMsg->LinkEndChild(pFarewell);
// 设置Farewell节点的值
strValue = _T("Thank you for using MyApp");
TiXmlText *pFarewellValue = new TiXmlText(strValue);
pFarewell->LinkEndChild(pFarewellValue);
// 生成子节点：Windows
TiXmlElement *pWindows = new TiXmlElement(_T("Windows"));
if (NULL==pWindows)
{
return false;
}
pRootEle->LinkEndChild(pWindows);
// 生成子节点：Window
TiXmlElement *pWindow = new TiXmlElement(_T("Window"));
if (NULL==pWindow)
{
return false;
}
pWindows->LinkEndChild(pWindow);
    // 设置节点Window的值
    pWindow->SetAttribute(_T("name"),_T("MainFrame"));
    pWindow->SetAttribute(_T("x"),_T("5"));
pWindow->SetAttribute(_T("y"),_T("15"));
    pWindow->SetAttribute(_T("w"),_T("400"));
    pWindow->SetAttribute(_T("h"),_T("250"));
// 生成子节点：Window
TiXmlElement *pConnection  = new TiXmlElement(_T("Connection"));
if (NULL==pConnection)
{
return false;
}
pRootEle->LinkEndChild(pConnection);
// 设置节点Connection的值
pConnection->SetAttribute(_T("ip"),_T("192.168.0.1"));
pConnection->SetAttribute(_T("timeout"),_T("123.456000"));
    pDoc->SaveFile(XmlFile);
return true;
}

不知你注意到上面的规律没有？首先父节点连接字节点使用函数LinkEndChild，使用方法是：pParentNode-> LinkEndChild(pChild);其次设置类似这种结构<Window name="MainFrame" x="5" y="15" w="400" h="250" />采用SetAttribute函数，这个函数有两个参数，前一个参数表示键，后一个参数表示键值，设置<Farewell>Thank you for using MyApp</Farewell>这种结构采用TiXmlText类，使用LinkEndChild函数进行连结。

上面是创建xml文件的代码，下面介绍读取xml文件的代码。打印整个xml文件的代码很简单，代码如下：

/*!
*  /brief 打印xml文件。
*
*  /param XmlFile xml文件全路径。
*  /return 是否成功。true为成功，false表示失败。
*/
bool PaintXml(std::string XmlFile)
{
// 定义一个TiXmlDocument类指针
TiXmlDocument *pDoc = new TiXmlDocument();
if (NULL==pDoc)
{
return false;
}
pDoc->LoadFile(XmlFile);
    pDoc->Print();
return true;
}

下次介绍使用tinyxml库对xml文件进行查询指定节点、删除指定节点、修改指定节点和增加节点的用法。

Visual C++ TinyXml快速入门（二）

Visual C++ TinyXml快速入门（三）