libxml教程(圖文詳解)

緣起
我的CloudBox需要一個跨平台的方案來解決iOS上以及Android上的xml檔案讀取問題
因為遊戲總是需要儲存一些設定值,或是過關存檔之類的
但又不能輕易的使用iOS內建提供的或著是Java內建提供的函數，這樣整起來會很麻煩
而且思考到以後增加新的平台,會有不小的困擾,最後決定就用libxml
libxml又是可以在windows環境下使用的，因此直接用visual studio也可以輕易嘗試學習API如何使用
環境簡介
作業系統: Windows XP
IDE工具: Visual Studio 2008
工程類型: Visual C++ Win32 Console Application
下載連結
lib及.h檔下載連結
http://xmlsoft.org/sources/win32/
dll下載連結
http://www.dll-files.com/dllindex/dll-files.shtml?iconv
http://www.dll-files.com/dllindex/dll-files.shtml?zlib1
http://www.dll-files.com/dllindex/dll-files.shtml?libxml2
設定說明圖解

，我在工程目錄中建立了兩個檔案夾，在libxml中放了iconv跟libxml的.h文檔
另外也建立了lib檔,將所有的lib都放進去

然後再項目工程中設定libaray的檔案路經跟include的檔案路徑
代碼說明
1. 讀取XML文檔

複製代碼 代碼如下: xmlDocPtr doc;
xmlNodePtr root;
// load an exist xml file.
doc = xmlParseFile("test.xml");
if (doc == NULL )
{
fprintf(stderr,"Document not parsed successfully. \n");
return 0;
}
// get root
root = xmlDocGetRootElement(doc);
if (root == NULL)
{
fprintf(stderr,"empty document\n");
xmlFreeDoc(doc);
return 0;
}

xmlDoc是一個struct，儲存了一個xml的相關資訊，例如檔案名稱、文件類型、子節點等等；xmlDocPtr等於xmlDoc*，它搞成這個樣子總讓人以為是智能指標，其實不是，要手動刪除的。
xmlParseFile函數以預設讀入一個UTF-8格式的文檔，並返迴文檔指標。
xmlReadFile函數讀入一個帶有某種編碼的xml文檔，並返迴文檔指標；細節見libxml2參考手冊。
xmlFreeDoc釋放文檔指標。
xmlDocGetRootElement函數得到根節點curNode
2.建立XML文檔
複製代碼 代碼如下: void CreateNewXMLDemo()
{
// create xml document
xmlDocPtr doc = xmlNewDoc(BAD_CAST"1.0");
xmlNodePtr root = xmlNewNode(NULL,BAD_CAST"root");

//set root
xmlDocSetRootElement(doc,root);

//add node
xmlNewTextChild(root, NULL, BAD_CAST "newNode1", BAD_CAST "newNode1 content");
xmlNewTextChild(root, NULL, BAD_CAST "newNode2", BAD_CAST "newNode2 content");
xmlNewTextChild(root, NULL, BAD_CAST "newNode3", BAD_CAST "newNode3 content");

//create node and add content

xmlNodePtr node = xmlNewNode(NULL,BAD_CAST"node2");
xmlNodePtr content = xmlNewText(BAD_CAST"NODE CONTENT");
xmlAddChild(root,node);
xmlAddChild(node,content);

// add attribute
xmlNewProp(node,BAD_CAST"attribute",BAD_CAST "yes");

//create son and grandson

node = xmlNewNode(NULL, BAD_CAST "son");
xmlAddChild(root,node);
xmlNewTextChild(node, NULL, BAD_CAST "grandson", BAD_CAST "grandson content");

xmlNodePtr grandson = xmlNewNode(NULL, BAD_CAST "grandson2");
xmlAddChild(node,grandson);
xmlAddChild(grandson, xmlNewText(BAD_CAST "This is a grandson2 node"));

//save xml

int nRel = xmlSaveFile("test3.xml",doc);

if (nRel != -1)
{
cout<<"create a xml:"<<nRel<<"bytes"<<endl;
}

//release

xmlFreeDoc(doc);
}

xmlChar是Libxml2中的字元類型，庫中所有字元、字串都是基於這個資料類型。事實上它的定義是：xmlstring.h
xmlNewDoc函數建立一個新的文檔指標。
xmlNewNode可以建立一個新的節點
xmlDocSetRootElement可以將該節點設為根節點
xmlNewTextChild直接添加一個文本子節點
第二建立節點的方式是先建立新節點，然後用xmlAddChild將新節點加入上層節點。
xmlNewProp可以建立節點的屬性
xmlSaveFile可以將xml存檔
因為總是要在xmlChar*和char*之間進行類型轉換，所以定義了一個宏BAD_CAST，其定義如下：xmlstring.h
#define BAD_CAST (xmlChar *)
3.遍曆節點,修改與刪除
複製代碼 代碼如下: xmlNodePtr head = root->children->next;
while(head != NULL)
{
if(head->type == XML_ELEMENT_NODE)
{
cout<<"Name:"<<head->name<<endl;
cout<<"Content:"<<xmlNodeGetContent(head->children)<<endl;
// update test05
if ((!xmlStrcmp(head->name, (const xmlChar *)"test05")))
{
xmlNodeSetContent(head->children,(const xmlChar *)"orz05");
}

// remove node
if (!xmlStrcmp(head->name, BAD_CAST "test07"))
{
xmlNodePtr tempNode;
tempNode = head->next;
xmlUnlinkNode(head);
xmlFreeNode(head);
head = tempNode;
continue;
}
}
head = head->next;
}

在libxml中只需要針對XML_ELEMENT_NODE型態的節點進行搜尋即可
xmlNodeGetContent可以取得節點的內文
xmlNodeSetContent可以設定節點的內文
可以透過xmlStrcmp來比較是否為要找的節點,xmlNodePtr的name屬性則是節點名稱,children則為內文節點
xmlUnlinkNode可以刪除節點

點擊下載完整工程