授權(quán)協(xié)議 BSD-3

開(kāi)發(fā)語(yǔ)言 C/C++

操作系統(tǒng) 跨平臺(tái)

軟件類型 開(kāi)源軟件

所屬分類 程序開(kāi)發(fā)、 XML相關(guān)工具

軟件簡(jiǎn)介

fastcxml 純 C語(yǔ)言編寫(xiě)的 XML 解析庫(kù)

什么是fastcxml?

fastcxml 是一款支持 XML 解析的多根節(jié)點(diǎn)的解析引擎，支持特性如下：

支持多根?XML，一個(gè)?XML?文檔支持多個(gè) ROOT 標(biāo)記，如下包含information?和?list：

?

    Josin
    26
    
Changsha



	Linux
	v5.0.1
	Git

?

支持XML文檔聲明，聲明必須位于第一行，以及眾多屬性，標(biāo)準(zhǔn)的XML聲明如下：

?

?

支持標(biāo)記的屬性特性，如下面的?information?標(biāo)記包含的?id?和?pid?屬性：

?

    Josin
    26
    
Changsha

?

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

?

     
    2 
    
Changsha

?

支持?CDATA標(biāo)記?防止瀏覽器轉(zhuǎn)義

?

 

    
     
    
Hunan

?

編譯 & 運(yùn)行

fastxml?可以在支持 C99標(biāo)準(zhǔn)的編譯器上編譯使用， 使用 cmake 編譯系統(tǒng)，需要安裝 cmake 3.13 以及以上版本

?

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

?

APIs 列表

從字符串解析?XML，返回?NULL?表示XML文件格式錯(cuò)誤

?

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

?

從CXML文件信息，解碼為字符串，返回的字符串需要通過(guò)?free?函數(shù)釋放

?

char *new_string_from_cxml(CXML *c);

?

釋放編碼后的?CXML?信息

?

int   trash_cxml(CXML *v);

?

快捷操作宏

?

// 用來(lái)定義一個(gè) CXML_n 的結(jié)構(gòu)來(lái)存儲(chǔ)解碼后的XML信息
CXML_FIELD_DEF(n)
// 中間使用 *aname 來(lái)定義一個(gè)節(jié)點(diǎn)名稱， 前面的 * 不能省略
CXML_FIELD_DEF_END(n);

// 用來(lái)聲明函數(shù)，用來(lái)在其他的文件引入聲明
CXML_FIELD_FUNC_DEF(n);

// 上面的聲明的實(shí)現(xiàn)文件
CXML_FIELD_FUNC(n)
  // 存在多個(gè)節(jié)點(diǎn)，信息，就定義多行
  // 第一個(gè)參數(shù)對(duì)應(yīng) XML的節(jié)點(diǎn)名稱，大小寫(xiě)區(qū)分
  // 第二個(gè)參數(shù)對(duì)應(yīng)上面第一步 CXML_FIELD_DEF(n) 中定義的名稱，去掉前綴 *
  // 第三個(gè)參數(shù)對(duì)應(yīng)第一個(gè)參數(shù)的字符個(gè)數(shù)
  // 第四個(gè)參數(shù)可選 if 或者 elif 第一行必須為 if
  CXML_FIELD_CMP(name, aname, l, e)
CXML_FIELD_FUNC_END();

?

怎么快速在C語(yǔ)言或者C++操作XML?

fastxml?自定了一系列的宏，來(lái)方便操作XML文檔，可以使用宏來(lái)快速完成XML文檔的解析與編碼，如下簡(jiǎn)短示例，針對(duì)于下面的?XML文檔，我們來(lái)看看我們的解析過(guò)程：

?

 

    
    
Hunan

?

操作流程如下：

新建 .h 和 .c 文件，如下命名為?xml_demo.c?和?xml_demo.h， 內(nèi)容如下：

xml_demo.h?文件內(nèi)容如下：

?

#include 

/**
 * @brief NOTICE
 * Simple example for using the macros
 */
CXML_FIELD_DEF(root) /* 括號(hào)內(nèi)的info可以隨意填寫(xiě)，如下相同 */
    *info /* 這里寫(xiě)上需要解析的 同級(jí)XML 節(jié)點(diǎn)名稱，上面的xml最外層的只有一個(gè) info節(jié)點(diǎn)，所以只有 *info */
CXML_FIELD_DEF_END(root);
CXML_FIELD_FUNC_DEF(root);

?

xml_demo.c?內(nèi)容如下：

?

CXML_FIELD_FUNC(root)
    CXML_FIELD_CMP(info,    info,    4,   if) // 第一個(gè)宏參數(shù)表示的解析的節(jié)點(diǎn)名稱，如果在上面的宏里面定義了 CXML_FIELD_DEF里面需要解析到一個(gè)不同的變量，可以定義第二個(gè)別名參數(shù)， 第三個(gè)參數(shù)表示的是第一個(gè)參數(shù)的字符長(zhǎng)度， 最后一個(gè)可以使 if 或者 elif，第一個(gè)限制為if，后續(xù)的為 elif
CXML_FIELD_FUNC_END(root);

?

在 main.c中開(kāi)始解析過(guò)程：

?

#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

?

因?yàn)檫@里的info節(jié)點(diǎn)是一個(gè)最外層的節(jié)點(diǎn)，它的值是一些子節(jié)點(diǎn)，所以如果需要解析他的子節(jié)點(diǎn)信息，需要重復(fù)上面的步驟，下面是一個(gè)整的示例，demo在demo目錄中：

xml_demo.h 內(nèi)容如下：

?

#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 內(nèi)容如下：

?

#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 內(nèi)容如下：

?

#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;
}

?

?