基於 C 語言的輕量級高效 XML 編解碼器

編輯：關於C語言

專案簡介

本專案實作一個基於 C 語言的輕量級 XML 編解碼器，專為嵌入式系統與資源受限環境設計。編解碼器支援標準 XML 1.0 規範的核心子集，包含元素巢狀、屬性解析、字元實體轉義、CDATA 區段處理等功能，同時透過記憶體池與流式解析技術，將執行期記憶體佔用降至最低。

核心特性

零拷貝解析： 直接在輸入緩衝區上操作指標，避免重複記憶體分配。
事件驅動模型： 提供 SAX 風格的回呼介面，適合串流處理大型 XML 文件。
DOM 樹構建選項： 可選擇建立完整記憶體樹，支援 XPath 風格查詢。
編碼自動偵測： 支援 UTF-8、UTF-16、GBK 等常見編碼，內建 BOM 識別。
錯誤恢復機制： 遇到格式錯誤可選擇跳過、報錯或嘗試修復繼續解析。

架構概覽

+------------------+     +------------------+     +------------------+
|   輸入層         |---->|   詞法分析器     |---->|   語法分析器     |
| (檔案/網路/記憶體)|     | (Tokenizer)      |     | (Parser)         |
+------------------+     +------------------+     +------------------+
                                                        |
                                                        v
                                               +------------------+
                                               |   事件分發/樹建構 |
                                               | (Handler/Builder) |
                                               +------------------+

快速開始

編譯安裝

git clone https://github.com/example/lightxml.git
cd lightxml
mkdir build && cd build
cmake .. && make
sudo make install

基本使用範例 (SAX 模式)

#include "lightxml.h"

void on_start_element(void *ctx, const char *name, const char **atts) {
    printf("開始元素: %s\n", name);
    for (int i = 0; atts[i]; i += 2) {
        printf("  屬性: %s = %s\n", atts[i], atts[i+1]);
    }
}

void on_end_element(void *ctx, const char *name) {
    printf("結束元素: %s\n", name);
}

void on_char_data(void *ctx, const char *data, int len) {
    printf("字元資料: %.*s\n", len, data);
}

int main() {
    XML_Parser parser = XML_ParserCreate(NULL);
    XML_SetElementHandler(parser, on_start_element, on_end_element);
    XML_SetCharacterDataHandler(parser, on_char_data);

    const char *xml = "Hello";
    XML_Parse(parser, xml, strlen(xml), 1);
    XML_ParserFree(parser);
    return 0;
}