libxml教程常用函数详解

XML 前端之家
前端之家收集整理的这篇文章主要介绍了libxml教程常用函数详解，前端之家小编觉得挺不错的，现在分享给大家，也给大家做个参考。


许多事物符合80/20法则，libxml中也是20%的函数提供了80%的功能。下面的列表列出了libxml的主要函数及其用法说明。

1. 全局函数说明

@H_404_10@

头文件引用

@H_404_10@

xml2config --cflags

@H_404_10@

库文件引用

@H_404_10@

xml2config --libs

@H_404_10@

主要头文件

@H_404_10@

parse.h

tree.h

xpath.h

@H_404_10@

简单例程

@H_404_10@

Makefile:

INCLUDE=-I./ -I$HOME/include `xml2config --cflags`

LIBRARY=-L./ -L$HOME/lib `xml2config --libs`

*.c或*.cpp

#include <libxml/parse.h>

#include <libxml/tree.h>

#include <libxml/xpath.h>

@H_404_10@

函数功能

@H_404_10@

在分析XML数据是，去除空白字符。如果不去除空白字符，则这些字符也会被当做一个node来处理

@H_404_10@

函数接口

@H_404_10@

int xmlKeepBlanksDefault(int val)

@H_404_10@

参数说明

@H_404_10@

val：0或者1。0表示去除空白字符，1表示不去除

返回值：0表示设置失败，1表示设置成功，一般不用判断

@H_404_10@

简单例程

@H_404_10@

xmlKeepBlanksDefault(0);

2. XML文件载入和保存函数

@H_404_10@

函数功能

@H_404_10@

将XML文件从硬盘上载入到内存中，并且生成DOM树。使用完毕之后，需要用xmlFreeDoc()来释放资源

@H_404_10@

函数接口

@H_404_10@

xmlDocPtr xmlParseFile(const char * filename)

@H_404_10@

参数说明

@H_404_10@

filename：XML文件名称。

返回值：如果载入成功，则返回这个文档的根节点。否则返回NULL

@H_404_10@

简单例程

@H_404_10@

xmlDodPtr pdoc;

pdoc = xmlParseFile("123.xml");

if( pdoc == NULL )

{

printf("Fail to parse XML file.\n");

}

@H_404_10@

函数功能

@H_404_10@

将内存中的DOM树，保存到硬盘上，生成一个带格式的XML文件

@H_404_10@

函数接口

@H_404_10@

int xmlSaveFormatFileEnc(const char * filename,xmlDocPtr cur,

const char * encoding,int format)

@H_404_10@

参数说明

@H_404_10@

filename：需要保存的文件的名称

cur：需要保存的XML文档

encoding：导出文件的编码类型，或者为NULL

format：是否格式化。0表示不格式化，1表示需要格式化。注意：只有当xmlIndentTreeOutput设置为1，或者xmlKeepBlanksDefault(0)时，format设置为1才能生效

返回值：写入文件中的字节数量

@H_404_10@

简单例程

@H_404_10@

xmlDodPtr pdoc;

pdoc = xmlParseFile("123.xml");

if( pdoc == NULL )

{

printf("Fail to parse XML file.\n");

}

Do_something_with_pdoc();

int filesize;

filesize = xmlSaveFormatFileEnc("321.xml",pdoc,"gb2312",1);

if(filesize == -1)

{

printf("Fail to save XML to file.\n");

}

3. XML内存载入和输出函数

@H_404_10@

函数功能

@H_404_10@

将一块内存中的XML数据生成一个DOM树。使用完毕之后，需要用xmlFreeDoc()来释放资源

@H_404_10@

函数接口

@H_404_10@

xmlDocPtr xmlParseMemory(const char * buffer,int size)

@H_404_10@

参数说明

@H_404_10@

buffer：存放XML格式数据的内存区

size：内存中XML格式数据的长度

返回值：如果载入成功，则返回这个文档的根节点；否则返回NULL

@H_404_10@

简单例程

@H_404_10@

char *buffer;

int size;

xmlDocPtr pdoc;

// read_data_to_buffer

buffer = ……

size = strlen(buffer);

pdoc = xmlParseMemory(buffer,size);

if( pdoc == NULL)

{

printf("Fail to parse XML buffer.\n");

}

@H_404_10@

函数功能

@H_404_10@

将DOM树导出到内存中，形成一个XML格式的数据

@H_404_10@

函数接口

@H_404_10@

void xmlDocDumpFormatMemoryEnc(xmlDocPtr out_doc,xmlChar ** doc_txt_ptr,

int * doc_txt_len,const char * txt_encoding,int format)

@H_404_10@

参数说明

@H_404_10@

out_doc：需要输出成为一个buffer的XML文档

doc_txt_ptr：输出文档的内存区。由该函数在内部申请。使用完成之后，必须调用xmlFree()函数来释放该内存块

doc_txt_len：输出文档内存区的长度

txt_encoding：输出文档的编码类型

format：是否格式化。0表示不格式化，1表示需要格式化。注意只有当xmlIndentTreeOutput设置为1，或者xmlKeepBlanksDefault(0)时，format设置为1才能生效

@H_404_10@

简单例程

@H_404_10@

xmlChar *outbuf;

int outlen;

xmlDocPtr pdoc;

pdoc = ……

xmlDocDumpFormatMemoryEnc(pdoc,&outbuf,&outlen,1);

xmlFree(outbuf);

4. 创建和释放XML文档函数

@H_404_10@

函数功能

@H_404_10@

在内存中创建一个新的XML文档。所创建的文档需要使用xmlFreeDoc()来释放资源

@H_404_10@

函数接口

@H_404_10@

xmlDocPtr xmlNewDoc (const xmlChar * version)

@H_404_10@

参数说明

@H_404_10@

version：XML标准的版本，目前只能指定为“1.0”

@H_404_10@

简单例程

@H_404_10@

xmlDocPtr pdoc ;

pdoc = xmlNewDoc((const xmlChar*)"1.0");

if( pdoc == NULL )

{

printf(“Fail to create new XML doc.\n”);

}

@H_404_10@

函数功能

@H_404_10@

释放内存中的XML文档

@H_404_10@

函数接口

@H_404_10@

void xmlFreeDoc(xmlDocPtr cur)

@H_404_10@

参数说明

@H_404_10@

cur：需要释放的XML文档

@H_404_10@

简单例程

@H_404_10@

xmlDocPtr pdoc ;

pdoc = xmlNewDoc((const xmlChar*)"1.0");

if( pdoc == NULL )

{

printf(“Fail to create new XML doc.\n”);

}

xmlFreeDoc(podc);

5. XML节点操作函数

@H_404_10@

函数功能

@H_404_10@

获得根节点

@H_404_10@

函数接口

@H_404_10@

xmlNodePtr xmlDocGetRootElement(xmlDocPtr doc)

@H_404_10@

参数说明

@H_404_10@

doc：XML文档句柄。

返回值：XML文档的根节点，或者NULL。

@H_404_10@

使用流程

@H_404_10@

① 解析好文档的根节点指针，应用使用该指针可以遍历XML文件

② xmlNodePtr的next字段，指向下一个同级XML节点

③ properties字段为xmlAttr类型，指向该XML节点的属性

④ children字段为xmlNodePtr类型，指向该XML节点的子节点

@H_404_10@

简单例程

@H_404_10@

xmlDocPtr pdoc ;

xmlNodePtr root ;

pdoc = xmlParseFile("123.xml");

if( pdoc == NULL )

{

printf("Fail to parse XML File.\n");

return ;

}

root = xmlDocGetRootElement(pdoc);

if( root == NULL)

{

printf("Fail to get root element\n");

return;

}

@H_404_10@

函数功能

@H_404_10@

设置根节点

@H_404_10@

函数接口

@H_404_10@

xmlNodePtr xmlDocSetRootElement(xmlDocPtr doc,xmlNodePtr root)

@H_404_10@

参数说明

@H_404_10@

doc：XML文档句柄

root：XML文档的新的根节点

返回值：如果该文档原来有根节点，则返回根节点，否则返回NULL

@H_404_10@

简单例程

@H_404_10@

xmlDocPtr pdoc ;

xmlNodePtr root;

pdoc = xmlNewDoc((const xmlChar*)"1.0");

if( pdoc == NULL )

{

printf("Fail to create new XML doc.\n");

return;

}

root = xmlNewDocNode(pdoc,NULL,(const xmlChar*)"root",NULL);

if( root == NULL )

{

printf("Fail to create doc node.\n");

return ;

}

xmlDocSetRootElement(pdoc,root);

@H_404_10@

函数功能

@H_404_10@

获得节点的内容

@H_404_10@

函数接口

@H_404_10@

xmlChar * xmlNodeGetContent (xmlNodePtr cur)

@H_404_10@

参数说明

@H_404_10@

cur：节点的指针

返回值：节点的文本内容。如果该节点没有文本内容，则返回NULL。当返回值不为NULL时，需要用xmlFree()函数来释放返回的资源

@H_404_10@

简单例程

@H_404_10@

xmlNodePtr node;

xmlChar* content;

node = ….

content = xmlNodeGetContent(node);

xmlFree(content);

@H_404_10@

函数功能

@H_404_10@

设置节点的内容长度

@H_404_10@

函数接口

@H_404_10@

void xmlNodeSetContentLen(xmlNodePtr cur,const xmlChar * content,int len)

@H_404_10@

参数说明

@H_404_10@

cur：节点的指针

content：节点的新文本内容

len：节点新文本内容的长度

@H_404_10@

简单例程

@H_404_10@

xmlNodePtr node;

xmlChar* content;

int len;

content = (xmlChar*)"1234567890";

len = strlen((char*)content);

xmlNodeSetContentLen(node,content,len);

@H_404_10@

函数功能

@H_404_10@

在节点的内容后面添加新的内容

@H_404_10@

函数接口

@H_404_10@

void xmlNodeAddContentLen(xmlNodePtr cur,int len)

@H_404_10@

参数说明

@H_404_10@

cur：节点的指针

content：节点的新加的文本内容

len：节点新加的文本内容的长度

@H_404_10@

简单例程

@H_404_10@

xmlNodePtr node;

xmlChar* content;

int len;

content = (xmlChar*)"1234567890";

len = strlen((char*)content);

xmlNodeAddContentLen(node,51); font-family:Arial; font-size:14px; line-height:26px"> @H_404_10@

函数功能

@H_404_10@

获得节点的属性

@H_404_10@

函数接口

@H_404_10@

xmlChar * xmlGetProp(xmlNodePtr node,const xmlChar * name)

@H_404_10@

参数说明

@H_404_10@

node：XML节点的指针

name：该节点的属性的名称

返回值：该属性的值或者为NULL。如果不为NULL，则需要用xmlFree()来释放资源

@H_404_10@

简单例程

@H_404_10@

xmlNodePtr node;

xmlChar* prop;

node = ….

prop = xmlGetProp(node,(const xmlChar*)"name");

if( prop != NULL)

xmlFree(prop);

@H_404_10@

函数功能

@H_404_10@

设置节点的属性（如果该属性已经存在，则替换其值）

@H_404_10@

函数接口

@H_404_10@

xmlAttrPtr xmlSetProp(xmlNodePtr node,const xmlChar * name,const xmlChar * value)

@H_404_10@

参数说明

@H_404_10@

node：需要设置属性的节点

name：属性的名称

value：属性的值

返回值：该属性节点的指针

@H_404_10@

简单例程

@H_404_10@

xmlNodePtr node;

xmlAttrPtr attr;

node = ….

attr = xmlSetProp(node,(cosnt xmlChar*)"Dept-Name",(const xmlChar*)"ES");

if( attr == NULL)

{

printf("Fail to set prop of this node.\n");

}

6. XPath函数

@H_404_10@

函数功能

@H_404_10@

生成xpath的上下文关系句柄

@H_404_10@

函数接口

@H_404_10@

xmlXPathContextPtr xmlXPathNewContext(xmlDocPtr doc)

@H_404_10@

参数说明

@H_404_10@

doc：需要处理的XML文档

返回值：该文档的XPath上下文关系句柄或者NULL。该返回句柄由函数内部申请，此函数调用者需要用xmlXPathFreeContext来释放

@H_404_10@

简单例程

@H_404_10@

xmlDocPtr pdoc;

xmlXPathContextPtr xpathctx;

pdoc = ….

xpathctx = xmlXPathNewContext(pdoc);

if( xpathctx != NULL)

xmlXPathFreeContext(xpathctx);

@H_404_10@

函数功能

@H_404_10@

释放xpath的上下文关系句柄

@H_404_10@

函数接口

@H_404_10@

void xmlXPathFreeContext(xmlXPathContextPtr ctxt)

@H_404_10@

参数说明

@H_404_10@

ctxt：需要释放的xpath上下文关系句柄

@H_404_10@

简单例程

@H_404_10@

参见xmlXPathNewContext()的例程

@H_404_10@

函数功能

@H_404_10@

执行xpath的表达式，返回结果内容节点集合

XPath表达式的表示方法，请参考：

http://www.zvon.org/xxl/XPathTutorial/General/examples.html

@H_404_10@

函数接口

@H_404_10@

xmlXPathObjectPtr xmlXPathEvalExpression (const xmlChar * str,

xmlXPathContextPtr ctxt)

@H_404_10@

参数说明

@H_404_10@

str：xpath表达式

ctxt：xpath的上下文关系句柄

返回值：满足表达式的结果集合或者为NULL。该返回句柄由函数内部申请，此函数调用者需要用xmlXPathFreeObject()来释放

@H_404_10@

简单例程

@H_404_10@

xmlDocPtr pdoc;

xmlXPathContextPtr xpathctx;

xmlXPathObjectPtr xpathobj;

pdoc = ….

xpathctx = xmlXPathNewContext(pdoc);

if( xpathctx == NULL)

{

printf("Fail to create xpath context.\n");

return ;

}

Xpathobj = xmlXPathEvalExpression(BAD_CAST "//@value",xpathctx);

if( xpathobj == NULL)

{

printf("Fail to evaluate xpath expression.\n");

xmlXPathFreeContext(xpathctx);

return;

}

xmlXPathFreeObject(xpathobj);

xmlXPathFreeContext(xpathctx);

结果集说明：

xpathobj-> nodesetval：存储结果列表，如果为NULL，表示无结果

xpathObj->nodesetval->nodeNr：表示结果的数量

xpathObj->nodesetval->nodeTab：表示结果的数组，可以通过下标访问

例如：

int number;

xmlNodePtr node;

if( xpathobj-> nodesetval == NULL)

number = 0;

else

number = xpathObj->nodesetval->nodeNr;

for(int i=0;i<number;i++)

{

node = xpathObj->nodesetval->nodeTab[i];

do_some_work_with_node();

}

@H_404_10@

函数功能

@H_404_10@

释放xpath表达式运算结果集

@H_404_10@

函数接口

@H_404_10@

void xmlXPathFreeObject(xmlXPathObjectPtr obj)

@H_404_10@

参数说明

@H_404_10@

obj：需要释放的xpath表达式运算结果集合

@H_404_10@

简单例程

@H_404_10@

参见xmlXPathEvalExpression()的例程

7. XML常见使用函数列表

下文是对XML常见使用函数的简要说明，有些函数的具体说明见上面的表格。

<libxml/parser.h>

int xmlKeepBlanksDefault (int val) //设置是否忽略空白节点,比如空格,在分析前必须调用,默认值是0,最好设置成1。

xmlDocPtr xmlParseFile (const char * filename) //分析一个xml文件,并返回一个文档对象指针

<libxml/tree.h>

//xml操作的基础结构提及其指针类型

//xmlDoc xmlDocPtr 文档对象的结构体及其指针

//xmlNode xmlNodePtr 节点对象的结构体及其指针

//xmlAttr xmlAttrPtr 节点属性的结构体及其指针

//xmlNs xmlNsPtr 节点命名空间的结构及其指针

//根节点相关函数

xmlNodePtr xmlDocGetRootElement (xmlDocPtr doc) //获取文档根节点

xmlNodePtr xmlDocSetRootElement (xmlDocPtr doc,xmlNodePtr root) //设置文档根节点

//创建子节点相关函数

xmlNodePtr xmlNewNode (xmlNsPtr ns,const xmlChar * name) //创建新节点

xmlNodePtr xmlNewChild (xmlNodePtr parent,xmlNsPtr ns,const xmlChar * content) //创建新的子节点

xmlNodePtr xmlCopyNode (const xmlNodePtr node,int extended) //复制当前节点

//添加子节点相关函数

xmlNodePtr xmlAddChild (xmlNodePtr parent,xmlNodePtr cur) //给指定节点添加子节点

xmlNodePtr xmlAddNextSibling (xmlNodePtr cur,xmlNodePtr elem) //添加后一个兄弟节点

xmlNodePtr xmlAddPrevSibling (xmlNodePtr cur,xmlNodePtr elem) //添加前一个兄弟节点

xmlNodePtr xmlAddSibling (xmlNodePtr cur,xmlNodePtr elem) //添加兄弟节点

//属性相关函数

xmlAttrPtr xmlNewProp (xmlNodePtr node,const xmlChar * value) //创建新节点属性

xmlChar * xmlGetProp (xmlNodePtr node,const xmlChar * name) //读取节点属性

xmlAttrPtr xmlSetProp (xmlNodePtr node,const xmlChar * value) //设置节点属性

//作用同尾部同名的字符串函数。只不过针对相应的xml节点

xmlChar* xmlStrcat (xmlChar *cur,const xmlChar * add)

const xmlChar *xmlStrchr(const xmlChar * str,xmlChar val)

int xmlStrcmp (const xmlChar * str1,const xmlChar * str2)

int xmlStrlen (const xmlChar * str)

xmlChar *xmlStrncat (xmlChar * cur,const xmlChar * add,int len)

int xmlStrncmp (const xmlChar * str1,const xmlChar * str2,51); font-family:Arial; font-size:14px; line-height:26px"> const xmlChar *xmlStrstr (const xmlChar * str,const xmlChar * val)

摘录自《深入浅出Linux工具与编程》

猜你在找的XML相关文章

10分钟掌握XML、JSON及其解析
引言 NOKIA 有句著名的广告语：“科技以人为本”。任何技术都是为了满足人的生产生活需要而...
[CXF REST标准实战系列] 一、JAXB xml与javaBean的转换
Writer：BYSocket（泥沙砖瓦浆木匠） 微博：BYSocket 豆瓣：BYSocket Reprint it anywhere...
[CXF REST标准实战系列] 一、JAXB xml与javaBean的转换
Writer：BYSocket（泥沙砖瓦浆木匠） 微博：BYSocket 豆瓣：BYSocket Reprint it anywhere...
10分钟掌握XML、JSON及其解析
http://blog.jobbole.com/79252/ 引言 NOKIA 有句著名的广告语：“科技以人为本”。任何技...
自定义圆形控件RoundImageView并认识一下attr.xml
(点击上方公众号，可快速关注) 公众号：smart_android 作者：耿广龙｜loonggg 点击“阅读原...
10分钟掌握XML、JSON及其解析
引言 NOKIA 有句著名的广告语：“科技以人为本”。任何技术都是为了满足人的生产生活需要而...
10分钟掌握XML、JSON及其解析(上)
 (点击上方公众号，可快速关注) 来源： Long Luo 的博客 链接：http://longluo.github.i...
10分钟掌握XML、JSON及其解析(中)
接上文 二、JSON XML很好很强大，但是最近有另外一个时代弄潮儿，这就是JSON。现在JSON的光...
10分钟掌握XML、JSON及其解析(下)
接上文 2.4 如何解析JSON？ Android JSON所有相关类，都在org.json包下。 包括JSONObject、...
10分钟掌握XML、JSON及其解析
原文出处：  Long Luo 的博客（@Long_Luo）   引言 NOKIA 有句著名的广告语：“科技以人...
HTMLHTML5JavaScriptCSSjQueryBootstrapAngularjsTypeScriptVueDojoJsonElectronNode.jsextjsExpress XMLES6AjaxFlashUnityReactFlexAnt DesignWeb前端微信小程序微信公众号
关闭广告单独headers封装代码提示错误整数正则非0开头跳页出页码antd table提示URL未注册公众号支付vue hash模式iSlider车牌键盘循环图片echarts 双折左右布局DllPlugin对象创建打字游戏圈选两栏云函数蒙版ES2020橱窗无缝滚动轮播色块碰撞组件销毁文档操作