libxml2常用函数

1.创建文件时常用的函数及其作用
创建XML文档中需要：新建文件、新建节点、设置节点内容、设置节点属性、建立节点之间的关系、保存文档等；
（1）xmlNewDoc()
原型：xmlDocPtr xmlNewDoc (const xmlChar *version);
参数：version : xmlChar string giving the version of XML “1.0”
返回值：Returns : a new document
功能：生成一个xml文档

（2）xmlNewNode()
函数原型：xmlNodePtr xmlNewNode (xmlNsPtr ns,const xmlChar *name);
参数： ns : namespace if any
name : the node name
返回值：Returns : a pointer to the new node object.
功能：Creation of a new node element. ns is optional (NULL).

（3）xmlNodeSetContent ()
函数原型：void xmlNodeSetContent (xmlNodePtr cur,const xmlChar *content);
参数：cur : the node being modified
content : the new value of the content
功能：Replace the content of a node.

(4)xmlNewProp ()
函数原型：xmlAttrPtr xmlNewProp (xmlNodePtr node,const xmlChar *name,const xmlChar *value);
参数：node : the holding node
name : the name of the attribute
value : the value of the attribute
返回值：Returns : a pointer to the attribute
功能：Create a new property carried by a node.

(5)xmlAddChild ()
xmlNodePtr xmlAddChild (xmlNodePtr parent,xmlNodePtr cur);
参数：parent : the parent node
cur : the child node
返回值：Returns : the child or NULL in case of error.
功能：将一个节点设置为另外一个节点的子节点

(6)xmlDocSetRootElement ()
函数原型：xmlNodePtr xmlDocSetRootElement (xmlDocPtr doc,xmlNodePtr root);
参数：doc : the document
root : the new document root element
Returns : the old root element if any was found
功能：Set the root element of the document (doc->children is a list containing possibly comments,PIs,etc …).
设置某个节点为整个文档的根节点

(7)xmlDocDumpMemory ()
函数原型：void xmlDocDumpMemory (xmlDocPtr cur,xmlChar **mem,int *size);
参数：cur : the document
mem : OUT: the memory pointer
size : OUT: the memory length
功能：Dump an XML document in memory and return the xmlChar * and it’s size. It’s up to the caller to free the memory with xmlFree().
将生成的xml DOM树保存到内存中（不是硬盘）

(8)xmlDocDumpformatMemory ()
void xmlDocDumpformatMemory (xmlDocPtr cur,int *size,int format);
与xmlDocDumpMemory ()类似，区别在于可以选择保存的格式
此系列函数还包括：
xmlDocDump、xmlDocDumpformatMemoryEnc、 xmlDocDumpMemory、xmlDocDumpMemoryEnc、xmlDocFormatDump

(9)xmlSaveFormatFileEnc ()
函数原型：int xmlSaveFormatFileEnc (const char *filename,xmlDocPtr cur,const char *encoding,int format);
参数：filename : the filename or URL to output
cur : the document being saved
encoding : the name of the encoding to use or NULL.
format : should formatting spaces be added.
Returns : the number of bytes written or -1 in case of error.
功能：将xml文件保存在硬盘
此系列的函数还包括：xmlSaveFileEnc
特别注意一种情况：将xml形式的字符串转换为xml文档的函数xmlParseMemory()和xmlParseDoc();

2.解析xml文档
解析xml文档的过程中可能有的操作：将文件导入、获得节点的属性、获得节点的内容、
(1)获得节点内容函数xmlNodeGetContent ()
函数原型：xmlChar* xmlNodeGetContent (xmlNodePtr cur);
参数： cur : the node being read
返回值：Returns : a new xmlChar * or NULL if no content is available. It’s up to the caller to free the memory with xmlFree().
功能：Read the value of a node,this can be either the text carried directly by this node if it’s a TEXT node or the aggregate string of the values carried by this node child’s (TEXT and ENTITY_REF). Entity references are substituted.

（2）获得节点属性函数xmlGetProp ()
函数原型：xmlChar* xmlGetProp (xmlNodePtr node,const xmlChar *name);
参数：node : the node
name : the attribute name
返回值：Returns : the attribute value or NULL if not found. It’s up to the caller to free the memory with xmlFree().
功能：Search and get the value of an attribute associated to a node This does the entity substitution. This function looks in DTD attribute declaration for FIXED or default declaration values unless DTD use has been turned off.

（3）读入xml字符形式的文件xmlReadfile()
使用xmlSaveFormatFileEnc()将xml文档存为文件之后，可以使用xmlReadfile读入
xmlDocPtr doc=xmlReadFile(szDocname,”UTF-8”,XML_PARSE_RECOVER);
doc = xmlReadFile(szDocName,“GB2312”,XML_PARSE_RECOVER);//以GB2312的编码方式读入解析文件

(4)获得根节点
xmlNodePtr xmlDocgetRootElement(xmlDocPtr doc)

(5)设置xml文档的上下文指针
context = xmlXPathNewContext(pdoc);

（6）计算满足xpath表达式的节点
result = xmlXPathEvalExpression(xpath,context);

libxml2常用函数

相关文章