前陣子做一個客服回覆玩家問題的小工具,需要讀寫 XML 檔案的資料。同事推薦了 TinyXML,於是展開了這段折騰過程。以下把配置、編碼陷阱與增刪讀寫的完整做法整理出來,給同樣需要的人一個參考。
先到官方網站下載 TinyXML 的原始碼,接著在解壓目錄中找到這六個檔案:tinystr.h、tinyxml.h、tinystr.cpp、tinyxml.cpp、tinyxmlerror.cpp、tinyxmlparser.cpp,全部加入自己的專案。
然後在需要用到它的原始碼中引入兩個標頭檔:
#include "tinyxml.h" #include "tinystr.h"
如果是 MFC 專案,還要在 tinystr.cpp、tinyxml.cpp、tinyxmlerror.cpp、tinyxmlparser.cpp 這四個檔案的第一行加上預編譯標頭:
#include "stdafx.h"
完成以上步驟,就可以開始寫程式了。
<?xml version="1.0" encoding="gb2312" standalone="yes"?>
<root xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance">
<prop>
<id>100</id>
<title>test 1</title>
</prop>
<prop>
<id>200</id>
<title>test 2</title>
</prop>
</root>
這裡的 encoding 要設成 gb2312。我最初寫成 utf-8,結果程式寫入中文完全正常,但讀出來時卻會出錯——尾端的 </ 這類符號被當成值一起讀了出來。和同事討論後才確認,問題出在編碼宣告與實際檔案編碼不一致。這是中文環境下用 TinyXML 最常踩到的一腳。
string fileFullPath = "XML 檔案的絕對路徑"; // 建立文件物件 TiXmlDocument* myDocument = new TiXmlDocument(fileFullPath.c_str()); // 載入檔案內容 myDocument->LoadFile(); // 取得根節點 TiXmlElement* RootElement = myDocument->RootElement();
TinyXML 的 API 幾乎就是照著樹狀結構長出來的:FirstChildElement() 取第一個子元素,NextSiblingElement() 往後走。把這兩個方法用熟了,整棵樹都能走透。
// 取得第一個子節點
TiXmlElement* CurrentPerson = RootElement->FirstChildElement();
// 迴圈遍歷所有節點
while (CurrentPerson)
{
// 第一個子節點:id
TiXmlElement* IdElement = CurrentPerson->FirstChildElement();
int nodeID = atoi(IdElement->FirstChild()->Value());
// 第二個子節點:title
TiXmlElement* TitleElement = IdElement->NextSiblingElement();
CString nodeTitle = TitleElement->FirstChild()->Value();
// ……若還有後續節點,用 NextSiblingElement() 依序往下取
// ……在這裡處理取出的資料
// 移到下一筆
CurrentPerson = CurrentPerson->NextSiblingElement();
}
要留意的是:元素的內容其實是它的「文字子節點」,所以取值時必須多走一層 FirstChild()->Value(),直接對元素取值會拿不到東西。
以新增 id 為 300、title 為 test3 的記錄為例:
// 建立 prop 節點並掛到根節點下
TiXmlElement* PersonElement = new TiXmlElement("prop");
RootElement->LinkEndChild(PersonElement);
// 建立兩個子節點
TiXmlElement* IdElement = new TiXmlElement("id");
TiXmlElement* TitleElement = new TiXmlElement("title");
PersonElement->LinkEndChild(IdElement);
PersonElement->LinkEndChild(TitleElement);
// 建立文字節點
TiXmlText* idContent = new TiXmlText("300");
TiXmlText* titleContent = new TiXmlText("test3");
IdElement->LinkEndChild(idContent);
TitleElement->LinkEndChild(titleContent);
// 寫回檔案
myDocument->SaveFile(fileFullPath.c_str());
以刪除 id 為 300 的記錄為例,先從自己快取的資料中找出對應的節點指標,再從根節點移除:
// 取得要刪除的節點(由快取資料依 id 找出) TiXmlElement* childElement = /* ... */; // 從父節點移除 RootElement->RemoveChild(childElement); // 寫回檔案 myDocument->SaveFile(fileFullPath.c_str());
用 TinyXML 的關鍵,其實就是把節點的層級關係想清楚:誰是父、誰是子、兄弟節點怎麼串起來。這張脈絡一旦通順,剩下的增刪改讀都只是幾行程式碼的事。
原文連結:https://www.cnblogs.com/skydesign/archive/2011/11/08/2240528.html