Frozen完全指南：10分钟掌握C/C++中scanf/printf风格的JSON操作
项目地址: https://gitcode.com/gh_mirrors/fro/frozen Frozen是一个专为C/C++设计的轻量级JSON解析和生成库，采用类似scanf/printf的接口风格，特别适合嵌入式系统和资源受限环境。作为一款简单高效的JSON处理工具，Frozen让C/C++开发者能够像处理普通数据格式一样轻松操作JSON数据。
🚀 为什么选择Frozen？
在嵌入式开发和资源受限的环境中，传统的JSON库往往过于臃肿。Frozen以其极小的内存占用和无依赖的特性脱颖而出：
- 超小体积：代码精简，适合嵌入式系统
- 零依赖：纯C实现，无需额外库支持
- 直观接口：采用熟悉的scanf/printf风格
- 跨平台：完全兼容ISO C/C++标准
- 完整功能：支持解析、生成、修改JSON
📦 快速入门安装
使用Frozen非常简单，只需将两个文件添加到你的项目中：
// 在你的项目中包含这两个文件
#include "frozen.h"
#include "frozen.c"
或者通过CMake集成：
add_subdirectory(frozen)
target_link_libraries(your_target PRIVATE frozen)
🔧 核心API详解
json_scanf() - 从JSON读取数据
json_scanf()函数让你能够像使用scanf()一样从JSON字符串中提取数据：
const char *json = "{\"name\": \"Alice\", \"age\": 30, \"active\": true}";
char name[32];
int age;
bool active;
// 使用类似scanf的语法解析JSON
json_scanf(json, strlen(json), "{name: %Q, age: %d, active: %B}",
name, &age, &active);
格式说明符：
%d- 整数%B- 布尔值（true/false）%Q- 字符串（自动分配内存）%V- Base64编码数据%M- 自定义处理函数
json_printf() - 生成JSON数据
创建JSON数据同样简单：
char buffer[256];
struct json_out out = JSON_OUT_BUF(buffer, sizeof(buffer));
json_printf(&out, "{name: %Q, age: %d, active: %B}",
"Bob", 25, true);
// 结果: {"name": "Bob", "age": 25, "active": true}
🎯 实战应用场景
场景1：配置文件读写
// 写入配置文件
json_fprintf("config.json",
"{server: {host: %Q, port: %d}, timeout: %d}",
"localhost", 8080, 30);
// 读取配置文件
char *content = json_fread("config.json");
char host[64];
int port, timeout;
json_scanf(content, strlen(content),
"{server: {host: %Q, port: %d}, timeout: %d}",
host, &port, &timeout);
free(content);
场景2：网络数据解析
// 解析HTTP响应中的JSON
void handle_response(const char *json) {
int status;
char message[128];
json_scanf(json, strlen(json),
"{status: %d, message: %Q}",
&status, message);
if (status == 200) {
printf("成功: %s\n", message);
}
}
场景3：嵌入式设备配置
// 在内存受限的嵌入式设备中使用
struct device_config {
int sampling_rate;
bool enable_logging;
char device_id[32];
} config;
const char *config_json = "{\"sampling_rate\":1000,\"enable_logging\":true,\"device_id\":\"sensor_001\"}";
json_scanf(config_json, strlen(config_json),
"{sampling_rate: %d, enable_logging: %B, device_id: %Q}",
&config.sampling_rate, &config.enable_logging, config.device_id);
🔄 高级特性
1. JSON路径操作
Frozen支持类似JavaScript的路径语法访问嵌套数据：
const char *json = "{\"user\": {\"profile\": {\"name\": \"Alice\"}}}";
char name[32];
// 使用路径访问嵌套属性
json_scanf(json, strlen(json), ".user.profile.name: %Q", name);
2. 动态修改JSON
const char *original = "{\"a\": 1, \"b\": 2}";
char buffer[256];
struct json_out out = JSON_OUT_BUF(buffer, sizeof(buffer));
// 修改现有JSON
json_setf(original, strlen(original), &out, ".b", "%d", 42);
// 结果: {"a": 1, "b": 42}
3. 数组遍历
const char *json = "{\"items\": [1, 2, 3, 4, 5]}";
struct json_token token;
int i = 0;
// 遍历数组元素
while (json_scanf_array_elem(json, strlen(json), ".items", i, &token) > 0) {
printf("索引 %d: %.*s\n", i, token.len, token.ptr);
i++;
}
📊 性能对比
与其他JSON库相比，Frozen在嵌入式环境中表现优异：
| 特性 | Frozen | cJSON | RapidJSON |
|---|---|---|---|
| 内存占用 | 极低 | 中等 | 较高 |
| 依赖项 | 无 | 无 | 需要STL |
| 代码大小 | ~2KB | ~10KB | ~100KB |
| 易用性 | 优秀 | 良好 | 复杂 |
| 嵌入式友好 | ✅ | ⚠️ | ❌ |
🛠️ 调试技巧
启用详细日志
// 在编译时启用调试
#define FROZEN_DEBUG 1
#include "frozen.h"
错误处理
int result = json_scanf(json, strlen(json), fmt, ...);
if (result < 0) {
printf("JSON解析错误: %d\n", result);
}
📈 最佳实践
- 内存管理：使用
%Q格式符时记得释放内存 - 缓冲区大小：为
json_printf()提供足够大的缓冲区 - 错误检查：总是检查
json_scanf()的返回值 - 路径验证：在访问嵌套属性前验证路径有效性
- 最小化模式：在极度受限的环境中使用
-DJSON_MINIMAL=1
🎉 开始使用
要开始使用Frozen，只需克隆仓库：
git clone https://gitcode.com/gh_mirrors/fro/frozen
然后将frozen.h和frozen.c复制到你的项目中。查看单元测试文件获取更多使用示例。
💡 常见问题解答
Q: Frozen支持浮点数吗？
A: 在完整模式下支持，在最小化模式（-DJSON_MINIMAL=1）下仅支持整数。
Q: 如何处理大型JSON文件？
A: Frozen支持流式处理，可以使用json_walk()进行回调式解析。
Q: 是否支持Unicode？
A: 是的，Frozen完全支持UTF-8编码。
Q: 线程安全吗？
A: Frozen的函数是线程安全的，只要不共享输出缓冲区。
🚀 下一步
现在你已经掌握了Frozen的核心概念，可以：
Frozen让C/C++中的JSON操作变得简单直观，特别适合嵌入式系统和性能敏感的应用场景。开始使用Frozen，享受简洁高效的JSON处理体验吧！ 🎯
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
