开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > Internet/网络编程 > 浏览器 > 查看源码
xml.h
资源名称：Client.rar　[点击查看]
上传用户：szjkjd
上传日期：2022-06-27
资源大小：8968k
文件大小：10k
源码类别：

浏览器

开发平台：

Visual C++

xml.h：源码内容
  1. /***********************************************************************
  2.  *
  3.  * 注意:
  4.  *     1. 所有函数参数、返回值的字符串都应该是UTF-8的格式
  5.  *     2. 执行xml_select_nodes之后，如果再执行除
  6.  *        xml_read_set_prop、xml_read_set_content、
  7.  *        xml_write_set_prop、xml_write_set_content之外的函数,
  8.  *        结构体中的上下文信息会被破坏。
  9.  *
  10.  *                                      作者：庾庆达    日期：2008-8-1
  11. ***********************************************************************/
  13. #ifndef _LIB_DB_XML_H_
  14. #define _LIB_DB_XML_H_
  16. #include "libxmlxpath.h"
  17. #include "libxmlparser.h"
  18. #include "list.h"
  20. typedef struct _XMLStr TXMLStr;
  21. struct _XMLStr
  22. {
  23.         FIFO_ENTRY(TXMLStr) node;
  24.         char *str;
  25. };
  27. typedef struct _XML TXML;
  28. struct _XML
  29. {
  30.         xmlDocPtr doc;
  31.         char *filename;
  32.         char *encoding;
  33.         xmlXPathObjectPtr object;
  34.         FIFO(TXMLStr) rubbish;
  35. };
  37. #ifdef __cplusplus
  38. extern "C" {
  39. #endif
  41. /***********************************************************************
  42.  * 功能: 创建新的xml实例
  43.  * @filename    : 文件路径, 该参数可以为NULL
  44.  * @encoding    : XML文件编码
  45.  * @root        : 根节点名称
  46.  * 返回值       : 成功返回xml实例, 失败返回NULL
  47.  **********************************************************************/
  48. TXML *xml_create(const char *filename, const char *encoding, const char *root);
  49. /***********************************************************************
  50.  * 功能: 读取xml文件
  51.  * @filename    : 文件路径
  52.  * 返回值       : 成功返回xml实例, 失败返回NULL
  53.  **********************************************************************/
  54. TXML *xml_create_file(const char *filename);
  56. /***********************************************************************
  57.  * 功能: 从内存中加载xml
  58.  * @buffer      : xml所在缓冲区
  59.  * @size        : buffer大小
  60.  * 返回值       : 成功返回xml实例, 失败返回NULL
  61.  **********************************************************************/
  62. TXML *xml_create_memory(const char *buffer, size_t size);
  64. /***********************************************************************
  65.  * 功能: 内存清理.(该函数会被xml_free调用)
  66.  * @xml         : xml实例
  67.  **********************************************************************/
  68. void xml_cleanup(TXML *xml);
  70. /***********************************************************************
  71.  * 功能: 释放xml实例.
  72.  * @xml         : xml实例
  73.  **********************************************************************/
  74. void xml_close(TXML *xml);
  76. /***********************************************************************
  77.  * 功能: 保存xml实例到文件中
  78.  * @xml         : xml实例
  79.  * 返回值       : 0 - 成功, other - 失败
  80.  * 注意         : 不能用于xml_create_memory和xml_create参数filename为
  81.  *                NULL时创建的xml实例
  82.  **********************************************************************/
  83. int xml_save(TXML *xml);
  85. /***********************************************************************
  86.  * 功能: 保存xml实例到文件中
  87.  * @xml         : xml实例
  88.  * @filename    : 保存路径
  89.  * 返回值       : 0 - 成功, other - 失败
  90.  **********************************************************************/
  91. int xml_save_to(TXML *xml, const char *filename);
  93. /***********************************************************************
  94.  * 功能: 保存xml实例到文件中,然后释放xml实例
  95.  * @xml         : xml实例
  96.  * 返回值:      0 - 成功, other - 失败
  97.  * 注意         : 不能用于xml_create_memory创建的xml实例。
  98.  *                即使保存失败, xml实例同样被关闭。
  99.  **********************************************************************/
  100. int xml_save_close(TXML *xml);
  102. ///////////////////////////////////////////////////////////////////////
  103. ///////////////////////////////////////////////////////////////////////
  104. ///////////////////////////////////////////////////////////////////////
  106. /***********************************************************************
  107.  * 功能: 执行xpath查询,以获取节点集合
  108.  * @xml         : xml实例
  109.  * @xpath       : xpath语句
  110.  * 返回值       : 成功返回节点个数, 失败返回-1
  111.  **********************************************************************/
  112. int xml_select_nodes(TXML *xml, const char *xpath);
  114. /***********************************************************************
  115.  * 功能: 获取调用xml_do_xpath后获得的节点集合中节点属性
  116.  * @xml         : xml实例
  117.  * @index       : 节点序号(从0开始)
  118.  * @name        : 属性名称
  119.  * 返回值       : 成功返回属性值, 失败返回NULL
  120.  **********************************************************************/
  121. char *xml_read_set_prop(TXML *xml, const int index, const char *name);
  123. /***********************************************************************
  124.  * 功能: 获取调用xml_select_nodes后获得的节点集合中节点注释
  125.  * @xml         : xml实例
  126.  * @index       : 节点序号(从0开始)
  127.  * 返回值       : 成功返回注释值, 失败返回NULL
  128.  **********************************************************************/
  129. char *xml_read_set_content(TXML *xml, const int index);
  131. /***********************************************************************
  132.  * 功能: 新增或修改调用xml_select_nodes后获得的节点集合中节点属性
  133.  * @xml         : xml实例
  134.  * @index       : 节点序号(从0开始)
  135.  * @name        : 属性名称
  136.  * @value       : 属性值
  137.  * 返回值       : 0 - 成功, other - 失败
  138.  **********************************************************************/
  139. int xml_write_set_prop(TXML *xml, const int index, const char *name, const char *value);
  141. /***********************************************************************
  142.  * 功能: 新增或修改调用xml_select_nodes后获得的节点集合中节点正文
  143.  * @xml         : xml实例
  144.  * @index       : 节点序号(从0开始)
  145.  * 返回值       : 成功返回注释值, 失败返回NULL
  146.  **********************************************************************/
  147. int xml_write_set_content(TXML *xml, const int index, const char *value);
  149. /***********************************************************************
  150.  * 功能: 获取符合xpath的首个节点的属性值
  151.  * @xml         : xml实例
  152.  * @xpath       : xpath路径
  153.  * @name        : 属性名称
  154.  * 返回值       : 成功返回属性值, 失败返回NULL
  155.  **********************************************************************/
  156. char *xml_read_item_prop(TXML *xml, const char *xpath, const char *name);
  158. /***********************************************************************
  159.  * 功能: 获取符合xpath的首个节点的注释
  160.  * @xml         : xml实例
  161.  * @index       : 节点序号(从0开始)
  162.  * 返回值       : 成功返回注释值, 失败返回NULL
  163.  **********************************************************************/
  164. char *xml_read_item_content(TXML *xml, const char *xpath);
  166. /***********************************************************************
  167.  * 功能: 新增或修改符合xpath的首个节点的属性值
  168.  * @xml         : xml实例
  169.  * @xpath       : xpath路径
  170.  * @name        : 属性名称
  171.  * 返回值       : 成功返回属性值, 失败返回NULL
  172.  **********************************************************************/
  173. int xml_write_item_prop(TXML *xml, const char *xpath, const char *name, const char *value);
  175. /***********************************************************************
  176.  * 功能: 新增或修改符合xpath的首个节点的注释
  177.  * @xml         : xml实例
  178.  * @index       : 节点序号(从0开始)
  179.  * 返回值       : 成功返回注释值, 失败返回NULL
  180.  **********************************************************************/
  181. int xml_write_item_content(TXML *xml, const char *xpath, const char *value);
  183. ///////////////////////////////////////////////////////////////////////
  184. ///////////////////////////////////////////////////////////////////////
  185. ///////////////////////////////////////////////////////////////////////
  187. /***********************************************************************
  188.  * 功能: 为符合xpath的节点新增子节点
  189.  * @xml         : xml实例
  190.  * @xpath       : xpath语句
  191.  * @name        : 新增节点名称
  192.  * @...         : 新增节点的属性名、属性值、...、最后是注释，然后是NULL.
  193.  *                属性名和属性值必须成对出现。
  194.  * 返回值       : 0 - 成功, other - 失败返回NULL
  195.  * 注意         : xpath匹配多个节点会导致函数执行失败.
  196.  **********************************************************************/
  197. int xml_add_child(TXML *xml, const char *xpath, const char *name, ...);
  199. /***********************************************************************
  200.  * 功能: 为符合xpath的节点之前新增一个兄弟节点
  201.  * @xml         : xml实例
  202.  * @xpath       : xpath语句
  203.  * @name        : 新增节点名称
  204.  * @...         : 新增节点的属性名、属性值、...、最后是注释，然后是NULL.
  205.  *                属性名和属性值必须成对出现。
  206.  * 返回值       : 0 - 成功,other - 失败
  207.  * 注意         : xpath匹配多个节点会导致函数执行失败.
  208.  **********************************************************************/
  209. int xml_add_prev_sibling(TXML *xml, const char *xpath, const char *name, ...);
  211. /***********************************************************************
  212.  * 功能: 为符合xpath的节点之后新增兄弟节点
  213.  * @xml         : xml实例
  214.  * @xpath       : xpath语句
  215.  * @name        : 新增节点名称
  216.  * @...         : 新增节点的属性名、属性值、...、最后是注释，然后是NULL.
  217.  *                属性名和属性值必须成对出现。
  218.  * 返回值       : 0 - 成功,other - 失败
  219.  * 注意         : xpath匹配多个节点会导致函数执行失败.
  220.  **********************************************************************/
  221. int xml_add_next_sibling(TXML *xml, const char *xpath, const char *name, ...);
  223. /***********************************************************************
  224.  * 功能: 为符合xpath的节点新增子节点
  225.  * @xml         : xml实例
  226.  * @xpath       : xpath语句
  227.  * @name        : 新增节点名称
  228.  * @...         : 新增节点的属性名、属性值、...、最后是注释，然后是NULL.
  229.  *                属性名和属性值必须成对出现。
  230.  * 返回值       : 0 - 成功,other - 失败
  231.  * 注意         : xpath匹配多个节点会导致函数执行失败.
  232.  **********************************************************************/
  233. int xml_add_sibling(TXML *xml, const char *xpath, const char *name, ...);
  235. /***********************************************************************
  236.  * 功能: 移除所有符合xpath的节点
  237.  * @xml         : xml实例
  238.  * @xpath       : xpath语句
  239.  * 返回值       : 0 - 成功, other - 失败
  240.  **********************************************************************/
  241. int xml_remove(TXML *xml, const char *xpath);
  243. #ifdef __cplusplus
  244. }
  245. #endif
  247. #endif
  249. // vim: ts=8 sw=8 expandtab