yyjson 快速入门教程

1. 项目目录结构及介绍

yyjson 的目录结构如下：

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

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

2. 项目的启动文件介绍

由于 yyjson 是一个库，没有典型的“启动文件”。但它提供了几个示例，可以作为学习如何使用它的起点。例如，examples/simple.c 显示了一个简单的 JSON 解析和序列化过程：

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

编译并运行这个例子，你可以了解如何在你的程序中集成 yyjson 库。

3. 项目的配置文件介绍

yyjson 使用标准的 GNU 编译选项进行构建，没有特定的配置文件。通常，你可以通过以下方式编译项目：

$ git clone https://github.com/ibireme/yyjson.git
$ cd yyjson
$ make

这将创建一个名为 libyyjson.a 的静态库文件，以及一个用于测试的可执行文件。如果你的系统上有 clang 或者 gcc，上面的 make 命令应该能够正确工作。如果你想链接动态库或修改编译选项（如优化级别），则需要手动编辑 Makefile 或使用类似 cmake 的构建工具。

请注意，yyjson 遵循 ANSI C 标准，因此应该可以在大多数平台上编译，而不需要额外的配置。若需针对特定平台进行调整，可以直接编辑源代码或者使用条件编译标志。