C/C++中最快的json库

程序喵大人

924人浏览 · 2025-12-02 19:08:17

程序喵大人 · 2025-12-02 19:08:17 发布

博主介绍：程序喵大人

35 - 资深C/C++/Rust/Android/iOS客户端开发
10年大厂工作经验
嵌入式/人工智能/自动驾驶/音视频/游戏开发入门级选手
《C++20高级编程》《C++23高级编程》等多本书籍著译者
更多原创精品文章，首发gzh，见文末
👇👇记得订阅专栏，以防走丢👇👇
😉C++基础系列专栏
😃C语言基础系列专栏
🤣C++大佬养成攻略专栏
🤓C++训练营
👉🏻个人网站

yyjson是一款高性能的JSON库，完全采用ANSI C（C89）编写，确保了跨平台的兼容性。它不仅在现代CPU上能够以每秒数GB的速度读写JSON数据，还严格遵循RFC 8259 JSON标准，确保了严格的数字格式和UTF-8验证。yyjson的设计理念是提供一个快速、便携、严格且可扩展的JSON处理工具，适用于各种高性能计算场景。以下是对yyjson的详细介绍及其使用示例。

一、yyjson概述

1.1 项目背景与优势

yyjson项目旨在提供一个高性能的JSON处理库，适用于需要快速、高效解析和序列化JSON数据的场景。其优势主要体现在以下几个方面：

高性能：yyjson能够在现代处理器上实现极高的读写速度，这得益于其优化的算法和对现代编译器的良好支持。
跨平台兼容性：完全采用ANSI C（C89）编写，确保了跨平台的兼容性，可以在大多数平台上编译，而不需要额外的配置。
严格遵循JSON标准：严格遵循RFC 8259 JSON标准，确保了数据的准确性和一致性。
灵活性：支持无限嵌套级别、\u0000字符和非空终止字符串，满足各种复杂需求。
丰富的选项：允许开发者自定义内存分配器、允许注释和尾随逗号等，极大地增强了其适用性。

1.2 项目目录结构

yyjson的目录结构如下：

├── examples  # 示例代码
│   └── ...
├── src      # 源代码
│   ├── yyjson.c  # 主要的 JSON 解析和序列化实现
│   ├── yyjson.h  # 头文件，提供公共接口
│   └── ...
├── test     # 测试用例
│   ├── bench  # 性能基准测试
│   ├── check  # 单元测试
│   └── ...
└── README.md  # 项目简介和指南

examples：提供了使用yyjson进行解析和序列化的示例程序。
src：包含核心库的源代码，主要由yyjson.c和yyjson.h组成，yyjson.h定义了API接口。
test：各种测试文件，包括性能基准测试和单元测试。

二、yyjson功能详解

2.1 JSON解析

yyjson提供了高效的JSON解析功能，可以将JSON格式的字符串解析成相应的数据结构。解析后的数据结构可以通过API进行访问和操作。

解析过程：

调用yyjson_read函数将JSON字符串解析成yyjson_doc对象。
使用yyjson_doc_get_root函数获取解析后的JSON对象的根节点。
使用yyjson_obj_get等函数获取具体的键值对。

示例代码：

#include <stdio.h>
#include "yyjson.h"

int main() {
    const char *json = "{\"key\":\"value\"}";
    
    // 解析 JSON 字符串
    yyjson_doc *doc = yyjson_read(json, strlen(json), YYJSON_READ_DEFAULT);
    if (!doc) {
        printf("parse error!\n");
        return 1;
    }
    
    // 获取 JSON 对象的 "key" 值
    yyjson_val *val = yyjson_obj_get(yyjson_doc_get_root(doc), "key");
    
    // 输出值
    printf("value: %s\n", yyjson_get_str(val));
    
    // 释放资源
    yyjson_doc_free(doc);
    
    return 0;
}

2.2 JSON序列化

yyjson也提供了高效的JSON序列化功能，可以将数据结构序列化成JSON格式的字符串。序列化后的字符串可以用于数据传输或存储。

序列化过程：

构造需要序列化的数据结构。
调用yyjson_write函数将数据结构序列化成JSON字符串。

示例代码：

#include <stdio.h>
#include "yyjson.h"

int main() {
    // 构造 JSON 对象
    yyjson_val obj = yyjson_obj();
    yyjson_obj_add(obj, "key", yyjson_str("value"));
    
    // 序列化 JSON 对象
    size_t len;
    char *json_str = yyjson_write(&obj, &len, YYJSON_WRITE_PRETTY | YYJSON_WRITE_ESCAPE_ALL);
    
    // 输出 JSON 字符串
    printf("%s\n", json_str);
    
    // 释放资源
    yyjson_free(json_str);
    yyjson_val_free(obj);
    
    return 0;
}