【笔记】cJSON 的使用经验记录

本文介绍了一个用于拼接两个cJSON JSON对象的函数,并详细分析了使用cJSON库进行JSON对象删除时可能遇到的问题及解决方案。通过具体实例说明了不当使用cJSON_Delete()函数可能导致的内存错误。

拼接两个 JSON 对象的函数

cJSON* LinkJson(cJSON* root1, cJSON* root2)
{
	if (root1 == NULL || root2 == NULL)
		return NULL;

	cJSON* res_root = cJSON_CreateObject();
	cJSON* item1 = root1->child;
	cJSON* item2 = root2->child;

	auto AddItemToObject = [&log](cJSON* root, cJSON* item)
	{
		switch (item->type)
		{
		case cJSON_Number:
			if (item->valuedouble != 0)
				cJSON_AddNumberToObject(root, item->string, item->valuedouble);
			else
				cJSON_AddNumberToObject(root, item->string, item->valueint);
			break;
		case cJSON_String:
			cJSON_AddStringToObject(root, item->string, item->valuestring);
			break;
		case cJSON_Object:
			cJSON_AddItemToObject(root, item->string, item);
			break;
		default:
			break;
		}
	};

	while (item1)
	{
		cJSON* next = item1->next;
		AddItemToObject(res_root, item1);
		item1 = next;
	}
	while (item2)
	{
		cJSON* next = item2->next;
		AddItemToObject(res_root, item2);
		item2 = next;
	}

	return res_root;
}

谨慎使用cJSON_Delete()

测试代码

int main()
{
	string timestamp = "2022-11-28 16:10:35.767";

	cJSON* root1 = cJSON_CreateObject();
	{
		cJSON* item1 = GenerateJsonItem(root1, 500, "", timestamp, "Signalname_0", "0:0", "M0A0");
		cJSON* item2 = GenerateJsonItem(root1, 500, "", timestamp, "Signalname_1", "0:1", "M0A1");
		printf("item1: \n%s\n\n", cJSON_Print(item1));
		printf("item2: \n%s\n\n", cJSON_Print(item2));
		printf("root1: \n%s\n\n", cJSON_Print(root1));
		cJSON_Delete(item1);
		cJSON_Delete(root1);
		cJSON_Delete(item2);
	}
}

cJSON* GenerateJsonItem(cJSON* root, int value, string unit, string timestamp, string name, string address, string identifier)
{
	cJSON* Signal = cJSON_CreateObject();
	cJSON_AddNumberToObject(Signal, "Value", value);
	cJSON_AddStringToObject(Signal, "Unit", unit.c_str());
	cJSON_AddStringToObject(Signal, "Timestamp", timestamp.c_str());
	cJSON_AddStringToObject(Signal, "Name", name.c_str());
	cJSON_AddStringToObject(Signal, "Address", address.c_str());
	cJSON_AddStringToObject(Signal, "Identifier", identifier.c_str());
	if (root != nullptr)
		cJSON_AddItemToObject(root, identifier.c_str(), Signal);
	return Signal;
}

创建了两个 cjson “对象” item1 与 item2 ,然后都插入 cjson “对象” root1 ,在调用 cJSON_Delete(item1); 之后调用 cJSON_Delete(root1); 或是 cJSON_Delete(root1); 都会导致程序崩溃。

崩溃原因

调用 cJSON_Delete(item1) 之后,item1 的参数全部失效,但自身的值还未置空。

在这里插入图片描述

之后调用 cJSON_Delete(root1) ,进入 while 循环,检测到 root1 的 child 指针指向 item1 “对象”,第一个 if 条件触发,进入1层嵌套,相当于再次调用了 cJSON_Delete(item1)
在这里插入图片描述
在 Debug 模式下,item1 的 child 指针的值被设为 0xfeeefeee ,非空,再次触发第一个 if 条件,,进入2层嵌套,相当于调用cJSON_Delete(0xfeeefeee)
第二层嵌套中尝试从 0xfeeefeee 获取 next 指针触发程序断点。
在这里插入图片描述

结论

  • 仍可以把用 cJSON 组织的 JSON 数据视为树结构。这个树结构中,所有兄弟节点都形成一个双向循环链表。
  • cJSON_Delete() 会删除一个节点的所有兄弟结点和以它们为根的子树。可能还存在其他节点的指针指向被删除节点,所以应尽可能谨慎使用 cJSON_Delete()
  • 尽量只对没有兄弟结点的节点根节点调用 cJSON_Delete()

### 关于 cJSON使用方法 #### 解析 JSON 字符串 通过 `cJSON_Parse` 函数可以将 JSON 字符串解析为一个 cJSON 对象。如果解析失败,则可以通过 `cJSON_GetErrorPtr` 获取错误信息。 ```c #include "cjson.h" char* pJsonStr = "{\"key\":\"value\"}"; cJSON* pJsonObj = cJSON_Parse(pJsonStr); if (!pJsonObj) { printf("Error parsing JSON: [%s]\n", cJSON_GetErrorPtr()); return -1; } // 成功解析后的操作... cJSON_Delete(pJsonObj); // 删除对象以释放内存 ``` 此部分代码展示了如何解析 JSON 字符串并处理可能的错误情况[^1]。 --- #### 构造 JSON 数据 利用 cJSON 提供的一系列函数,可以动态构建复杂的 JSON 结构。以下是创建嵌套 JSON 对象的一个简单示例: ```c #include "cjson.h" #include <stdio.h> int main() { cJSON *root = cJSON_CreateObject(); cJSON_AddStringToObject(root, "name", "Alice"); cJSON_AddNumberToObject(root, "age", 25); cJSON *address = cJSON_CreateObject(); cJSON_AddStringToObject(address, "city", "New York"); cJSON_AddStringToObject(address, "country", "USA"); cJSON_AddItemToObject(root, "address", address); char *output = cJSON_Print(root); if (output != NULL) { printf("Generated JSON:\n%s\n", output); free(output); // 释放打印缓冲区 } cJSON_Delete(root); // 清理资源 return 0; } ``` 在此示例中,我们创建了一个根对象,并向其中添加字符串和数值类型的键值对。还演示了如何嵌入另一个子对象作为属性的一部分[^4]。 --- #### 访问 JSON 中的数据项 当需要访问已解析的 JSON 数据中的特定字段时,可使用 `cJSON_GetObjectItem` 函数获取指定名称对应的节点指针。 ```c cJSON *item = cJSON_GetObjectItem(pJsonObj, "keyName"); if (cJSON_IsString(item)) { printf("Value of key 'keyName': %s\n", item->valuestring); } else if (cJSON_IsNumber(item)) { printf("Value of key 'keyName': %d\n", item->valueint); } ``` 这里验证了目标字段是否存在以及其数据类型是否匹配预期[^3]。 --- #### 打印与序列化 JSON 完成 JSON 操作之后,通常希望将其转换回字符串形式以便存储或者传输给其他模块。这可通过调用 `cJSON_Print` 实现;而为了节省空间则可以选择紧凑模式——即不带任何空白字符版本的输出功能 `cJSON_PrintUnformatted`. ```c char *prettyOutput = cJSON_Print(root); // 带缩进格式化的输出 char *compactOutput = cJSON_PrintUnformatted(root); // 不含多余空格的纯文本表示法 ``` 以上两种方式均返回分配好的新字符串区域,因此记得适时释放它们所占用的空间以防泄漏问题发生。 --- ### 总结 综上所述,cJSON 库提供了丰富的 API 来简化开发者对于 JSON 数据结构的操作需求,无论是读取还是写入都非常便捷高效。掌握这些基本技巧后即可灵活应用于实际项目当中去解决各类涉及配置文件管理或是网络通信协议交互等方面的任务。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值