fastcxml xml解析库

授权协议 BSD-3

开发语言 C/C++

操作系统 跨平台

软件类型 开源软件

所属分类 程序开发、 XML相关工具

软件简介

fastcxml 纯 C语言编写的 XML 解析库

什么是fastcxml?

fastcxml 是一款支持 XML 解析的多根节点的解析引擎，支持特性如下：

支持多根 XML，一个 XML 文档支持多个 ROOT 标记，如下包含information 和 list：

    Josin
    26
    
Changsha



	Linux
	v5.0.1
	Git

支持XML文档声明，声明必须位于第一行，以及众多属性，标准的XML声明如下：

支持标记的属性特性，如下面的 information 标记包含的 id 和 pid 属性：

    Josin
    26
    
Changsha

支持注释，注意：注释不可以嵌套

     
    2 
    
Changsha

支持 CDATA标记 防止浏览器转义

 

    
     
    
Hunan

编译 & 运行

fastxml 可以在支持 C99标准的编译器上编译使用， 使用 cmake 编译系统，需要安装 cmake 3.13 以及以上版本

git clone https://gitee.com/josinli/fastxml.git
cd fastxml
mkdir build
cd build
cmake .. && make
./fastxml

APIs 列表

从字符串解析 XML，返回 NULL 表示XML文件格式错误

CXML *new_cxml_from_string(char *str, unsigned long long);

从CXML文件信息，解码为字符串，返回的字符串需要通过 free 函数释放

char *new_string_from_cxml(CXML *c);

释放编码后的 CXML 信息

int   trash_cxml(CXML *v);

快捷操作宏

// 用来定义一个 CXML_n 的结构来存储解码后的XML信息
CXML_FIELD_DEF(n)
// 中间使用 *aname 来定义一个节点名称， 前面的 * 不能省略
CXML_FIELD_DEF_END(n);

// 用来声明函数，用来在其他的文件引入声明
CXML_FIELD_FUNC_DEF(n);

// 上面的声明的实现文件
CXML_FIELD_FUNC(n)
  // 存在多个节点，信息，就定义多行
  // 第一个参数对应 XML的节点名称，大小写区分
  // 第二个参数对应上面第一步 CXML_FIELD_DEF(n) 中定义的名称，去掉前缀 *
  // 第三个参数对应第一个参数的字符个数
  // 第四个参数可选 if 或者 elif 第一行必须为 if
  CXML_FIELD_CMP(name, aname, l, e)
CXML_FIELD_FUNC_END();

怎么快速在C语言或者C++操作XML?

fastxml 自定了一系列的宏，来方便操作XML文档，可以使用宏来快速完成XML文档的解析与编码，如下简短示例，针对于下面的 XML文档，我们来看看我们的解析过程：

 

    
    
Hunan

操作流程如下：

新建 .h 和 .c 文件，如下命名为 xml_demo.c 和 xml_demo.h， 内容如下：

xml_demo.h 文件内容如下：

#include 

/**
 * @brief NOTICE
 * Simple example for using the macros
 */
CXML_FIELD_DEF(root) /* 括号内的info可以随意填写，如下相同 */
    *info /* 这里写上需要解析的 同级XML 节点名称，上面的xml最外层的只有一个 info节点，所以只有 *info */
CXML_FIELD_DEF_END(root);
CXML_FIELD_FUNC_DEF(root);

xml_demo.c 内容如下：

CXML_FIELD_FUNC(root)
    CXML_FIELD_CMP(info,    info,    4,   if) // 第一个宏参数表示的解析的节点名称，如果在上面的宏里面定义了 CXML_FIELD_DEF里面需要解析到一个不同的变量，可以定义第二个别名参数， 第三个参数表示的是第一个参数的字符长度， 最后一个可以使 if 或者 elif，第一个限制为if，后续的为 elif
CXML_FIELD_FUNC_END(root);

在 main.c中开始解析过程：

#include 
#include 

int main(int argc, char *argv[])
{
    char *xml_str = "\n"
                    " \n"
                    "\n"
                    "    \n"
                    "    
Hunan
\n"
                    "";
    CXML *xml = new_cxml_from_string(xml_str, strlen(xml_str));
    
    if ( !xml ) {
        printf("Your xml format is wrong.");
        trash_cxml(xml);
        return 0;
    }
    
    CXML_root *root = NEW_CXML_root_FROM_DATA(xml->data);
    printf("Root name: %s\n", root->info->key);
    TRASH_CXML_root(root);
    trash_cxml(xml);
}

输出如下：

Root name: info

因为这里的info节点是一个最外层的节点，它的值是一些子节点，所以如果需要解析他的子节点信息，需要重复上面的步骤，下面是一个整的示例，demo在demo目录中：

xml_demo.h 内容如下：

#include 

/**
 * @brief NOTICE
 * Simple example for using the macros
 */
CXML_FIELD_DEF(root)
    *info
CXML_FIELD_DEF_END(root);
CXML_FIELD_FUNC_DEF(root);

CXML_FIELD_DEF(info)
    *name, *age, *addr
CXML_FIELD_DEF_END(info);
CXML_FIELD_FUNC_DEF(info);

xml_demo.c 内容如下：

#include 


/**
 * @brief NOTICE
 * Simple example for parsing the XML data
 */
CXML_FIELD_FUNC(root)
    CXML_FIELD_CMP(info,   info,    4, elif)
CXML_FIELD_FUNC_END();

CXML_FIELD_FUNC(info)
    CXML_FIELD_CMP(name,    name,    4,   if)
    CXML_FIELD_CMP(address, addr,    7, elif)
CXML_FIELD_FUNC_END();

main.c 内容如下：

#include 
#include 


int main(int argc, char *argv[])
{
    char *xml_str = "\n"
                    " \n"
                    "\n"
                    "    \n"
                    "    
Hunan
\n"
                    "";
    CXML *xml = new_cxml_from_string(xml_str, strlen(xml_str));
    
    if ( !xml ) {
        printf("Your xml format is wrong.");
        trash_cxml(xml);
        return 0;
    }
    
    CXML_root *root = NEW_CXML_root_FROM_DATA(xml->data);
    printf("Root name: %s\n", root->info->key);
    
    CXML_info *info = NEW_CXML_info_FROM_DATA(root->info->val);

    printf("%s: %s\n", info->name->key, (char *)info->name->val);
    printf("%s: %s\n", info->addr->key, (char *)info->addr->val);

    TRASH_CXML_info(info);
    TRASH_CXML_root(root);
    trash_cxml(xml);
    
    return 0;
}