【cJSon】cJSON学习笔记(一)

本文涉及的产品
公共DNS(含HTTPDNS解析),每月1000万次HTTP解析
云解析 DNS,旗舰版 1个月
全局流量管理 GTM,标准版 1个月
简介:

1.JSON格式简述

JSON(JavaScript Object 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数据包的使用方法。

2.JSON结构体

熟悉使用cJSON库函数可从cJSON结构体入手,cJSON结构体如下所示:
[cpp]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. typedef struct cJSON {  
  2.  struct cJSON *next,*prev;   
  3.  struct cJSON *child;   
  4.  int type;   
  5.  char *valuestring;   
  6.  int valueint;  
  7.  double valuedouble;   
  8.  char *string;   
  9. } cJSON;  
cJSon类型
/* cJSON Types: */
#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
    
#define cJSON_IsReference 256
#define cJSON_StringIsConst 512

说明

1.cJOSN结构体为一个双向列表,并可通过child指针访问下一层。
2.type变量决定数据项类型(键的类型),数据项可以是字符串可以是整形,也可以是浮点型。如果是整形值的话可从valueint,如果是浮点型的话可从valuedouble取出,以此类推。
3.string可理解为节点的名称,综合此处的第2点可理解为“键”的名称。

3.解析JSON数据包

例如在QCA平台中读取一个开关量的结果,向QCA平台请求之后可以获得以下JSON数据包:
{"timestamp":"2013-11-19T08:50:11","value":1}
在这个JSON数据包中有两个数据项(键值对),一个是时间戳,该时间戳为字符串形式;另一个是开关值,该开关值为整型。该例子主要用于模拟向QCA平台请求开关量数据。

参考代码

[cpp]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. #include <stdio.h>  
  2. #include <stdlib.h>  
  3. #include "cJSON.h"  
  4. // 被解析的JSON数据包  
  5. char text[] = "{\"timestamp\":\"2013-11-19T08:50:11\",\"value\":1}";  
  6. int main (int argc, const char * argv[])  
  7. {  
  8.     cJSON *json , *json_value , *json_timestamp;  
  9.     // 解析数据包  
  10.     json = cJSON_Parse(text);  
  11.     if (!json)  
  12.     {  
  13.         printf("Error before: [%s]\n",cJSON_GetErrorPtr());  
  14.     }  
  15.     else  
  16.     {  
  17.         // 解析开关值  
  18.         json_value = cJSON_GetObjectItem( json , "value");  
  19.         if( json_value->type == cJSON_Number )  
  20.         {  
  21.             // 从valueint中获得结果  
  22.             printf("value:%d\r\n",json_value->valueint);  
  23.         }  
  24.         // 解析时间戳  
  25.         json_timestamp = cJSON_GetObjectItem( json , "timestamp");  
  26.         if( json_timestamp->type == cJSON_String )  
  27.         {  
  28.             // valuestring中获得结果  
  29.             printf("%s\r\n",json_timestamp->valuestring);  
  30.         }  
  31.         // 释放内存空间  
  32.         cJSON_Delete(json);  
  33.     }  
  34.     return 0;  
  35. }  

运行结果

value:1
2013-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数据包

组装数据包的过程和解析数据包的过程相反,下面的例子描述如何组装以下数据包,该数据包只有一个数据项(键值对)。该例子主要用于模拟向QCA平台上传传感器数据。
{
 "value": 123.400000
}

参考代码

[cpp]  view plain copy 在CODE上查看代码片 派生到我的代码片
  1. #include <stdio.h>  
  2. #include <stdlib.h>  
  3. #include "cJSON.h"  
  4. int main (int argc, const char * argv[])  
  5. {  
  6.     // 创建JSON Object  
  7.     cJSON *root = cJSON_CreateObject();  
  8.     // 加入节点(键值对),节点名称为value,节点值为123.4  
  9.     cJSON_AddNumberToObject(root,"value",123.4);  
  10.     // 打印JSON数据包  
  11.     char *out = cJSON_Print(root);  
  12.     printf("%s\n",out);  
  13.     // 释放内存  
  14.     cJSON_Delete(root);  
  15.     free(out);  
  16.     return 0;  
  17. }  

若干说明

1. cJSON_CreateObject函数可创建一个根数据项,之后便可向该根数据项中添加string或int等内容
2. cJSON_AddNumberToObject向节点中添加子节点,例如此处添加value节点,节点值为123.4
3. cJSON_Print函数可以打印根数据项,加入制表符换行符等标识符使得JSON数据包更易阅读
4. 使用free函数释放被out占用的内存空间

5.总结

整体来说cJSON简单易用,解决了JSON数据包解析和组装的问题,几乎就掌握了CJSON。

相关文章
|
1天前
Lua
【11月更文挑战第20天】
8 3
|
5月前
|
C++
写篇lua
写篇lua
|
JSON 编译器 API
[✔️]lua-cjson 编译,在unity中使用cjson
[✔️]lua-cjson 编译,在unity中使用cjson
268 0
|
存储 JSON API
cJSON使用教程
cJSON是一个使用C语言编写的JSON数据解析器,具有超轻便,可移植,单文件的特点,使用MIT开源协议。
cJSON使用教程
|
存储 JSON JavaScript
cJSON生成json字符串
嵌入式开发中如果需要上云常常需要处理json字符串,这时候可以调用json库如:cJSON,jasson等。本文介绍cJSON库使用
Lua 函数
Lua 函数
187 0
Lua 函数
|
机器学习/深度学习 移动开发 JSON
使用cJSON库解析JSON
cJSON库的下载 cJSON是一个基于C的JSON解析库,这个库非常简单,只有cJSON.c和cJSON.h两个文件,支持JSON的解析和封装,需要调用时,只需要#include "cJSON.h"就可以使用了, 库源码下载地址:cJSON download JSON官方网站:json 只包含键值对的JSON字符串解析 JSON字符串: { "name": "Andy", //键值对1 "age": 20 //键值对2 } 这个JSON对象只有两个键值对,键name对应字符串Andy,键age对应数字20。
2187 0
|
存储 JSON 数据格式
|
JSON 数据格式
cJSON系列(1) - cJSON 入门与应用
cJSON 入门与应用 1. cJSON简介 cJSON aims to be the dumbest possible parser that you can get your job done with. It's a single file of C, and a single header file. JSON is described best here: h
2314 0