C的xml编程-libxml2（函数总结篇）
--------------------------------------------------------------------------------------------------
l xmlChar 替代char,使用UTF-8编码的一字节字符串
l xmlDoc 包含由解析文档建立的树结构，xmlDocPtr是指向这个结构的指针。
l xmlNodePtr 和 xmlNode 包含单一结点的结构，xmlNodePtr是指向这个结构的指针，它被用于遍历文档树。
--------------------------------------------------------------------------------------------------
l xmlDocPtr doc; //定义文档指针
l doc = xmlNewDoc ("1.0"); //以version = 1.0建立文档
l doc = xmlParseFile(docname); //解析文档，给文档指针赋值
l doc = xmlReadFile(docname,"GB2312",XML_PARSE_RECOVER); //以GB2312编码解析文档
l xmlFreeDoc(doc); //释放解析文档时获取到的内存
l int nRel = xmlSaveFile("-",doc); //将文档以默认方式存入一个文件。
l xmlSaveFormatFile (docname, doc, 1); //保存文件到磁盘，第一个参数是写入文件的名，第二个参数是一个xmlDoc结构指针，第三个参数设定为1，保证在输出上写入。
l xmlSaveFormatFileEnc("-", doc, encoding, 1);//将文档以某种编码/格式存入一个文件中。
--------------------------------------------------------------------------------------------------
l xmlNodePtr cur; //定义结点指针
l xmlDocSetRootElement(doc, rootnode);
l cur = xmlDocGetRootElement(doc); //获取文档根结点
l cur = cur->xmlChildrenNode; //获取结点的子结点
l while (cur != NULL) {
……
cur = cur->next;
}
l xmlChar *key;
key = xmlNodeListGetString(doc, cur->xmlChildrenNode, 1); //获取文本结点的文本，需用其子结点
l xmlFree(key); //释放xmlNodeListGetString为其返回的字符串分配的内存
l xmlNewTextChild (cur, NULL, "keyword", "123"); //为当前节点添加一个新的子元素文本结点<keyword>123</keyword>，其中NULL是命名空间
l rootnode = xmlNewDocNode(doc, NULL, (const xmlChar*)"root", out);
l rootnode = xmlNewNode(NULL, (const xmlChar*)"root");
l xmlNodePtr content = xmlNewText((xmlChar *)"NODE CONTENT"); //注意不是xmlNewTextChild()
l xmlAddChild(root_node,node);//为root_node添加子结点node
l xmlNewChild(root_node, NULL, (xmlChar *) "node1",(xmlChar *) szOut);//为root_node添加子结点node1
l xmlNodeSetContent(curNode, (xmlChar *) "content changed");
l mlUnlinkNode(curNode); //将当前节点从文档中断链（unlink），这样本文档就不会再包含这个子节点
l xmlFreeNode(curNode); //手动删除断链节点的内存, 若没有xmlDelNode或者xmlRemoveNode，使用此函数
--------------------------------------------------------------------------------------------------
l xmlAttrPtr newattr;
newattr = xmlNewProp (newnode, "uri", "123"); //为结点newnode添加属性uri,属性值为123
l if (xmlHasProp(curNode,(xmlChar *)"attribute")) //判断结点curNode是否具有属性attribute
l xmlAttrPtr attrPtr = propNodePtr->properties; //属性集是链表
l xmlChar *uri;
uri = xmlGetProp(cur, "uri"); //获取属性值
xmlFree(uri); //释放内存
l xmlSetProp(curNode,BAD_(xmlChar *)"attribute", (xmlChar *) "no"); //设置当前结点的attribute属性的属性值为no
--------------------------------------------------------------------------------------------------
l xmlXPathContextPtr context;
l context = xmlXPathNewContext(doc); //获取context指针
l xmlXPathObjectPtr result;
l result = xmlXPathEvalExpression(xmlChar *xpath, context); //根据条件xpath以及context来进行查询，条件格式：xmlChar *szXpath =(xmlChar *) ("/root/node2[@attribute='yes']");
l xmlXPathFreeContext(context); //释放context内存
l if(xmlXPathNodeSetIsEmpty(result->nodesetval)) //判断查询后的结果是否为空
l xmlNodeSetPtr nodeset; //创建节点集指针
l nodeset = result->nodesetval; //这个结点集对象包含在集合中的元素数目(nodeNr)及一个结点数组(nodeTab)。
l for (i=0; i < nodeset->nodeNr; i++)
l keyword = xmlNodeListGetString(doc, nodeset->nodeTab[i]->xmlChildrenNode, 1)
l xmlXPathFreeObject (result); //释放内存
l xmlCleanupParser();
--------------------------------------------------------------------------------------------------
l xmlMalloc是动态分配内存的函数；xmlFree是配套的释放内存函数；xmlStrcmp是字符串比较函数;
l 基本上xmlChar字符串相关函数都在xmlstring.h中定义；而动态内存分配函数在xmlmemory.h中定义。
l xml2-config –cflags //取得预处理和编译标志
l xml2-config –libs //取得链接标志
--------------------------------------------------------------------------------------------------
