Normandy 博客

本指南中的例子代碼示范如何做到：
• 解析文檔
• 取得指定元素的文本
• 添加一個(gè)元素及它的內(nèi)容
• 添加一個(gè)屬性
• 取得一個(gè)屬性的值
例子的完整代碼包含在附錄中
 
數(shù)據(jù)類型
Libxml 定義了許多數(shù)據(jù)類型，我們將反復(fù)碰到它們，它隱藏了雜亂的來源以致你不必處理它除非你有特定的需要。xmlChar  替代char,使用UTF-8編碼的一字節(jié)字符串。如果你的數(shù)據(jù)使用其它編碼，它必須被轉(zhuǎn)換到UTF-8才能使用libxml的函數(shù)。在libxml編碼支持WEB頁(yè)面有更多關(guān)于編碼的有用信息。
XmlDoc 包含由解析文檔建立的樹結(jié)構(gòu)，xmlDocPtr是指向這個(gè)結(jié)構(gòu)的指針。
xmlNodePtr and xmlNode 包含單一結(jié)點(diǎn)的結(jié)構(gòu)xmlNodePtr是指向這個(gè)結(jié)構(gòu)的指針，它被用于遍歷文檔樹。
 
解析文檔
解析文檔時(shí)僅僅需要文件名并只調(diào)用一個(gè)函數(shù)，并有錯(cuò)誤檢查。完整代碼：附錄C, Keyword例程代碼
 
①xmlDocPtr doc;
②xmlNodePtr cur;
③doc = xmlParseFile(docname);
④if (doc == NULL ) {
    fprintf(stderr,"Document not parsed successfully. \n");
    return;
}
⑤cur = xmlDocGetRootElement(doc);
⑥if (cur == NULL) {
    fprintf(stderr,"empty document\n");
    xmlFreeDoc(doc);
    return;
}
⑦if (xmlStrcmp(cur->name, (const xmlChar *) "story")) {
    fprintf(stderr,"document of the wrong type, root node != story");
    xmlFreeDoc(doc);
    return;
}
①定義解析文檔指針。
②定義結(jié)點(diǎn)指針(你需要它為了在各個(gè)結(jié)點(diǎn)間移動(dòng))。
④檢查解析文檔是否成功，如果不成功，libxml將指一個(gè)注冊(cè)的錯(cuò)誤并停止。
 
注釋
一個(gè)常見錯(cuò)誤是不適當(dāng)?shù)木幋a。XML標(biāo)準(zhǔn)文檔除了用UTF-8或UTF-16外還可用其它編碼保存。如果文檔是這樣，libxml將自動(dòng)地為你轉(zhuǎn)換到UTF-8。更多關(guān)于XML編碼信息包含在XML標(biāo)準(zhǔn)中。
⑤取得文檔根元素
⑥檢查確認(rèn)當(dāng)前文檔中包含內(nèi)容。
⑦在這個(gè)例子中，我們需要確認(rèn)文檔是正確的類型。“Story”是在這個(gè)指南中使用文檔的根類型。
 
取得元素內(nèi)容
 
你找到在文檔樹中你要查找的元素后可以取得它的內(nèi)容。在這個(gè)例子中我們查找“story”元素。進(jìn)程將在冗長(zhǎng)的樹中查找我們感興趣的元素。我們假定期你已經(jīng)有了一個(gè)名為doc的xmlDocPtr和一個(gè)名為cur的xmlNodPtr。
①cur = cur->xmlChildrenNode;
②while (cur != NULL) {  
    if ((!xmlStrcmp(cur->name, (const xmlChar *)"storyinfo"))){
        parseStory (doc, cur);
    }
    cur = cur->next;
}
 
①取得cur的第一個(gè)子結(jié)點(diǎn)，cur指向文檔的根，即“story”元素。
②這個(gè)循環(huán)迭代通過“story”的子元素查找“storyinfo”。這是一個(gè)包含有我們將查找的“keywords”的元素。它使用了libxml字符串比較函數(shù)xmlStrcmp。如果相符，它調(diào)用函數(shù)parseStory。
 
void parseStory (xmlDocPtr doc, xmlNodePtr cur) {
xmlChar *key;
① cur = cur->xmlChildrenNode;
② while (cur != NULL) {
        if ((!xmlStrcmp(cur->name, (const xmlChar *)"keyword"))) {
③        key = xmlNodeListGetString(doc, cur->xmlChildrenNode, 1);
              printf("keyword: %s\n", key);
              xmlFree(key);
        }
        cur = cur->next;
    }
    return;
}
① 再次取得第一個(gè)子結(jié)點(diǎn)。
② 像上面那個(gè)循環(huán)一樣，我們能過迭代，查找我們感興趣的叫做“keyword”的元素。
③ 當(dāng)我們找到元素“keyword”時(shí)，我們需要打印它包含在XML中的記錄的內(nèi)容，文本被包含于元素的子結(jié)點(diǎn)中，因此我們借助了cur-> xmlChildrenNode，為了取得文本，我們使用函數(shù)xmlNodeListGetString，它有一個(gè)文檔指針參數(shù)，在這個(gè)例子中，我們僅僅打印它。
注釋
因?yàn)?/span>xmlNodeListGetString為它返回的字符串分配內(nèi)存，你必須使用xmlFree釋放它。
 
使用XPath取得元素內(nèi)容
除了一步步遍歷文檔樹查找元素外，Libxml2包含支持使用Xpath表達(dá)式取得指定結(jié)點(diǎn)集。完整的Xpath API文檔在這里。Xpath允許通過路徑文檔搜索匹配指定條件的結(jié)點(diǎn)。在下面的例子中，我們搜索文檔中所有的“keyword”元素。 
 
注釋
下面是Xpath完整的討論。它詳細(xì)的使用資料，請(qǐng)查閱Xpath規(guī)范。
這個(gè)例子完整的代碼參見附錄D，XPath例程代碼。
Using XPath requires setting up an xmlXPathContext and then supplying the XPath expression and the context to the xmlXPathEvalExpression

function.
The function returns an xmlXPathObjectPtr, which includes the set of nodes satisfying the XPath expression.
使用XPath需要安裝xmlXPathContext才支持XPath表達(dá)式及xmlXPathEvalExpression函數(shù)，這個(gè)函數(shù)返回一個(gè)xmlXPathObjectPtr，它包含有

XPath表達(dá)式的結(jié)點(diǎn)集。
 
xmlXPathObjectPtr
getnodeset (xmlDocPtr doc, xmlChar *xpath){
①xmlXPathContextPtr context;
   xmlXPathObjectPtr result;
②context = xmlXPathNewContext(doc);
③result = xmlXPathEvalExpression(xpath, context);
④if(xmlXPathNodeSetIsEmpty(result->nodesetval)){
       printf("No result\n");
       return NULL;
   }
   xmlXPathFreeContext(context);
   return result;
}
①首先定義變量
②初始化變量context
③應(yīng)用XPath表達(dá)式
④檢查結(jié)果
由函數(shù)返回的xmlPathObjectPtr包含一個(gè)結(jié)點(diǎn)集和其它需要被迭代及操作的信息。在這個(gè)例子中我們的函數(shù)返回 xmlXPathObjectPtr，我們使用它打印我們文檔中keyword結(jié)點(diǎn)的內(nèi)容。這個(gè)結(jié)點(diǎn)集對(duì)象包含在集合(nodeNr)中的元素?cái)?shù)目及一個(gè)結(jié)點(diǎn)(nodeTab)數(shù)組。
 
①for (i=0; i < nodeset->nodeNr; i++) {
②keyword = xmlNodeListGetString(doc,
   nodeset->nodeTab[i]->xmlChildrenNode, printf("keyword: %s\n", keyword);
   xmlFree(keyword);
}
①變量nodeset->Nr持有結(jié)點(diǎn)集中元素的數(shù)量。我們使用它遍歷數(shù)組。
②打印每個(gè)結(jié)點(diǎn)包含的內(nèi)容。
注釋
Note that we are printing the child node of the node that is returned, because the contents of the keyword element are a child text node.注意我們打印的是結(jié)點(diǎn)的子結(jié)點(diǎn)的返回值，因?yàn)?/span>keyword元素的內(nèi)容是一個(gè)子文本結(jié)點(diǎn)。

寫元素
寫元素內(nèi)容使用上面許多一樣的步驟—解析文檔并遍歷樹。我們先解析文檔然后遍歷樹查找我們想插入元素的位置。在這個(gè)例子中，我們?cè)僖淮尾檎?/span>“storyinfo