cJSON的构造和解析
2016-03-29 12:10
344 查看
1.JSON格式简述
JSON(JavaScriptObject Notation) 是一种轻量级的数据交换格式。易于人阅读和编写,同时也易于机器解析和生成。它基于JavaScript(Standard ECMA-262 3rd Edition - December 1999)的一个子集。 JSON采用完全独立于语言的文本格式,但是也使用了类似于C语言家族的习惯(包括C, C++, C#, Java, JavaScript, Perl, Python等)。这些特性使JSON成为理想的数据交换语言。(来自“开源中国”资料)
cJSON是一个超轻巧,携带方便,单文件,简单的可以作为ANSI-C标准的JSON解析器。
接触yeelink平台之后,慢慢接触到JSON格式,虽然一些简单的情况可以通过string库函数解析和组装JSON数据包,但是若有cJSON库的帮助,解析和组装JSON数据包的工作便会变得简单的多,下面就从两个例子出发说明cJSON数据包的使用方法。
【相关博文】
【前端学习——JSON格式详解】
【cJSON学习笔记
续集】
2.JSON结构体
熟悉使用cJSON库函数可从cJSON结构体入手,cJSON结构体如下所示:[cpp] view
plain copy
typedef struct cJSON {
struct cJSON *next,*prev;
struct cJSON *child;
int type;
char *valuestring;
int valueint;
double valuedouble;
char *string;
} cJSON;
几点说明
1.cJOSN结构体为一个双向列表,并可通过child指针访问下一层。2.type变量决定数据项类型(键的类型),数据项可以是字符串可以是整形,也可以是浮点型。如果是整形值的话可从valueint,如果是浮点型的话可从valuedouble取出,以此类推。
// cJSON 类型:
#define cJSON_False 0
#define cJSON_True 1
#define cJSON_NULL 2
#define cJSON_Number 3
#define cJSON_String 4
#define cJSON_Array 5
#define cJSON_Object 6
3.string可理解为节点的名称,综合此处的第2点可理解为“键”的名称。
3.解析JSON数据包
例如在yeelink平台中读取一个开关量的结果,向yeelink平台请求之后可以获得以下JSON数据包:{"timestamp":"2013-11-19T08:50:11","value":1}
在这个JSON数据包中有两个数据项(键值对),一个是时间戳,该时间戳为字符串形式;另一个是开关值,该开关值为整型。该例子主要用于模拟向yeelink平台请求开关量数据。
参考代码
[cpp] viewplain copy
#include <stdio.h>
#include <stdlib.h>
#include "cJSON.h"
// 被解析的JSON数据包
char text[] = "{\"timestamp\":\"2013-11-19T08:50:11\",\"value\":1}";
int main (int argc, const char * argv[])
{
cJSON *json , *json_value , *json_timestamp;
// 解析数据包
json = cJSON_Parse(text);
if (!json)
{
printf("Error before: [%s]\n",cJSON_GetErrorPtr());
}
else
{
// 解析开关值
json_value = cJSON_GetObjectItem( json , "value");
if( json_value->type == cJSON_Number )
{
// 从valueint中获得结果
printf("value:%d\r\n",json_value->valueint);
}
// 解析时间戳
json_timestamp = cJSON_GetObjectItem( json , "timestamp");
if( json_timestamp->type == cJSON_String )
{
// valuestring中获得结果
printf("%s\r\n",json_timestamp->valuestring);
}
// 释放内存空间
cJSON_Delete(json);
}
return 0;
}
运行结果
value:12013-11-19T08:50:11
若干说明
1.cJSON_Parse函数负责解析JSON数据包,并按照cJSON结构体的结构序列化整个数据包。使用该函数会通过malloc函数在内存中开辟一个空间,使用完成需要手动释放。2.cJSON_GetObjectItem函数可从cJSON结构体中查找某个子节点名称(键名称),如果查找成功可把该子节点序列化到cJSON结构体中。
3.如果需要使用cJSON结构体中的内容,可通过cJSON结构体中的valueint和valuestring取出有价值的内容(即键的值)
4.可通过cJSON_Delete释放内存空间。
4.组装JSON数据包
组装数据包的过程和解析数据包的过程相反,下面的例子描述如何组装以下数据包,该数据包只有一个数据项(键值对)。该例子主要用于模拟向yeelink平台上传传感器数据。{
"value": 123.400000
}
参考代码
[cpp] viewplain copy
#include <stdio.h>
#include <stdlib.h>
#include "cJSON.h"
int main (int argc, const char * argv[])
{
// 创建JSON Object
cJSON *root = cJSON_CreateObject();
// 加入节点(键值对),节点名称为value,节点值为123.4
cJSON_AddNumberToObject(root,"value",123.4);
// 打印JSON数据包
char *out = cJSON_Print(root);
printf("%s\n",out);
// 释放内存
cJSON_Delete(root);
free(out);
return 0;
}
若干说明
1. cJSON_CreateObject函数可创建一个根数据项,之后便可向该根数据项中添加string或int等内容2. cJSON_AddNumberToObject向节点中添加子节点,例如此处添加value节点,节点值为123.4
3. cJSON_Print函数可以打印根数据项,加入制表符换行符等标识符使得JSON数据包更易阅读
4. 使用free函数释放被out占用的内存空间
5.总结
整体来说cJSON简单易用,解决了JSON数据包解析和组装的问题,向着心中的目标更近一步了。
6.参考资料
1.CJSON库介绍
相关文章推荐
- 如何组织构建多文件 C 语言程序(二)
- 如何写好 C main 函数
- Lua和C语言的交互详解
- 关于C语言中参数的传值问题
- 简要对比C语言中三个用于退出进程的函数
- 深入C++中API的问题详解
- 基于C语言string函数的详解
- C语言中fchdir()函数和rewinddir()函数的使用详解
- C语言内存对齐实例详解
- C语言编程中统计输入的行数以及单词个数的方法
- C语言自动生成enum值和名字映射代码
- 使用C语言判断英文字符大小写的方法
- c语言实现的带通配符匹配算法
- C语言实现顺序表基本操作汇总
- C语言中计算正弦的相关函数总结
- 使用C语言详解霍夫曼树数据结构
- 探讨C语言的那些小秘密之断言
- C语言实现BMP转换JPG的方法
- 深入探讨C语言中局部变量与全局变量在内存中的存放位置
- C语言查找数组里数字重复次数的方法