Frozen API深度解析：json_scanf和json_printf的10个实用技巧

Frozen API深度解析：json_scanf和json_printf的10个实用技巧

【免费下载链接】frozenJSON parser and generator for C/C++ with scanf/printf like interface. Targeting embedded systems.项目地址: https://gitcode.com/gh_mirrors/fro/frozen

Frozen是一款专为C/C++设计的轻量级JSON解析与生成库，采用类scanf/printf风格的接口，特别适合嵌入式系统开发。本文将分享使用json_scanf和json_printf的10个实用技巧，帮助开发者高效处理JSON数据。

1. 掌握路径匹配技巧

json_scanf支持通过点分路径和数组索引精确定位JSON元素，例如：

const char *json = "{\"user\":{\"name\":\"Alice\"},\"scores\":[90,85,95]}"; char *name; int score; // 提取用户姓名和第二个成绩 json_scanf(json, strlen(json), "{user.name:%Q, scores[1]:%d}", &name, &score);

路径匹配规则：

• 对象属性用.key表示（如.user.name）
• 数组元素用[index]表示（如.scores[1]）
• 支持嵌套结构（如.user.address.city）

2. 利用特殊格式符处理JSON类型

Frozen提供多种专用格式符处理不同JSON类型：

示例：解析布尔值和字符串

int enabled; char *config; json_scanf(json, len, "{enabled:%B, config:%Q}", &enabled, &config);

3. 优雅处理动态内存管理

使用%Q格式符时，Frozen会自动分配内存存储字符串，使用后需手动释放：

char *username; json_scanf(json, len, "{username:%Q}", &username); // 使用username... free(username); // 必须释放，防止内存泄漏

对于%H和%V格式符，同样需要释放解码后的数据：

int data_len; char *data; json_scanf(json, len, "{payload:%H}", &data_len, &data); // 使用data... free(data);

4. 使用json_printf构建复杂JSON

json_printf支持类似printf的语法构建JSON，自动处理转义和格式：

char buf[256]; struct json_out out = JSON_OUT_BUF(buf, sizeof(buf)); json_printf(&out, "{name:%Q, age:%d, scores:[%d,%d,%d]}", "Bob", 25, 90, 85, 95); // buf内容: {"name":"Bob","age":25,"scores":[90,85,95]}

5. 处理大数字和特殊数值

Frozen支持64位整数和浮点数处理，使用标准格式符：

int64_t big_num; double pi; json_scanf(json, len, "{big_num:%" PRId64 ", pi:%f}", &big_num, &pi);

生成时同样支持：

json_printf(&out, "{value:%" PRId64 "}", (int64_t)1234567890);

6. 自定义扫描和生成回调

通过%M格式符实现自定义数据处理：

// 自定义扫描回调 void scan_custom(const char *str, int len, void *user_data) { // 处理原始JSON片段 } // 自定义生成回调 int print_custom(struct json_out *out, va_list *ap) { // 自定义生成逻辑 return 0; } // 使用示例 json_scanf(json, len, "{custom:%M}", scan_custom, user_data); json_printf(&out, "{custom:%M}", print_custom);

7. 高效处理数组数据

使用json_printf_array宏简化数组生成：

int arr[] = {1, 2, 3, 4, 5}; json_printf(&out, "{numbers:%M}", json_printf_array, arr, sizeof(arr), sizeof(int), "%d");

解析数组元素可使用json_scanf_array_elem：

struct json_token token; json_scanf_array_elem(json, len, ".scores", 2, &token);

8. 错误处理与边界检查

json_scanf返回成功解析的元素数量，可用于错误检查：

int parsed = json_scanf(json, len, "{name:%Q, age:%d}", &name, &age); if (parsed != 2) { // 处理解析错误 }

生成JSON时注意缓冲区大小：

if (out.u.buf.len >= out.u.buf.size) { // 处理缓冲区溢出 }

9. 使用JSON_OUT宏简化输出

Frozen提供多种输出目标宏：

• JSON_OUT_BUF：输出到缓冲区
• JSON_OUT_FILE：输出到文件
• 自定义输出：实现printer函数

示例：输出到文件

FILE *fp = fopen("output.json", "w"); struct json_out out = JSON_OUT_FILE(fp); json_printf(&out, "{result:%d}", 1); fclose(fp);

10. 内存优化技巧

对于嵌入式系统，可通过宏定义控制功能，减少内存占用：

#define JSON_MINIMAL 1 // 最小化功能 #define JSON_MAX_DEPTH 16 // 限制嵌套深度 #define JSON_MAX_PATH_LEN 64 // 限制路径长度 #include "frozen.h"

使用json_asprintf动态分配内存：

char *json_str = json_asprintf("{name:%Q, id:%d}", "test", 123); // 使用json_str... free(json_str);

总结

Frozen库通过scanf/printf风格的接口，为C/C++开发者提供了简洁高效的JSON处理方案。掌握上述技巧可以帮助你在嵌入式系统等资源受限环境中轻松处理JSON数据。完整的API文档和更多示例可参考项目源码文件frozen.h和frozen.c。

要开始使用Frozen，可通过以下命令获取源码：

git clone https://gitcode.com/gh_mirrors/fro/frozen

通过合理利用json_scanf和json_printf的特性，你可以在保持代码简洁的同时，高效处理各种JSON数据结构。

【免费下载链接】frozenJSON parser and generator for C/C++ with scanf/printf like interface. Targeting embedded systems.项目地址: https://gitcode.com/gh_mirrors/fro/frozen