cJSON学习

发布时间：2020-12-16 19:35:08 所属栏目：百科来源：网络整理

导读：1.JSON格式简述 JSON(JavaScript Object Notation) 是一种轻量级的数据交换格式。易于人阅读和编写，同时也易于机器解析和生成。它基于JavaScript（Standard ECMA-262 3rd Edition - December 1999）的一个子集。 JSON采用完全独立于语言的文本格式，但是也

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

【相关博文】

【前端学习——JSON格式详解】

【cJSON学习笔记续集】

【json 的官方介绍中文翻译版本】

官网指定的地方下载的 ourceforge

2.JSON结构体

熟悉使用cJSON库函数可从cJSON结构体入手，cJSON结构体如下所示：

[cpp] view plain copy print ?

typedef struct cJSON {
struct cJSON *next,*prev;
struct cJSON *child;
int type;
char *valuestring;
int valueint;
double valuedouble;
char *string;
} cJSON;

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取出，以此类推。

3.string可理解为节点的名称，综合此处的第2点可理解为“键”的名称。

3.解析JSON数据包

例如在yeelink平台中读取一个开关量的结果，向yeelink平台请求之后可以获得以下JSON数据包：

{"timestamp":"2013-11-19T08:50:11","value":1}

在这个JSON数据包中有两个数据项（键值对），一个是时间戳，该时间戳为字符串形式；另一个是开关值，该开关值为整型。该例子主要用于模拟向yeelink平台请求开关量数据。

参考代码

[cpp] view plain copy print ?

#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:%drn",json_value->valueint);
}
// 解析时间戳
json_timestamp = cJSON_GetObjectItem( json, "timestamp");
if( json_timestamp->type == cJSON_String )
{
// valuestring中获得结果
printf("%srn",json_timestamp->valuestring);
}
// 释放内存空间
cJSON_Delete(json);
}
return 0;
}

#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_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:%drn",json_value->valueint);
        }
        // 解析时间戳
        json_timestamp = cJSON_GetObjectItem( json,"timestamp");
        if( json_timestamp->type == cJSON_String )
        {
            // valuestring中获得结果
            printf("%srn",json_timestamp->valuestring);
        }
        // 释放内存空间
        cJSON_Delete(json);
    }
    return 0;
}

运行结果

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数据包

组装数据包的过程和解析数据包的过程相反，下面的例子描述如何组装以下数据包，该数据包只有一个数据项（键值对）。该例子主要用于模拟向yeelink平台上传传感器数据。

{

"value": 123.400000

}

参考代码

[cpp] view plain copy print ?

#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("%sn",out);
// 释放内存
cJSON_Delete(root);
free(out);
return 0;
}

#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("%sn",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库介绍

引用：http://www.kuqin.com/shuoit/20141224/344068.html

http://www.52php.cn/article/p-vbtrbyni-bch.html

http://baike.baidu.com/link?url=IZYJmDP8VrpEMo3JdslDLnGWZEu7JZXLtrM1d6owEkQQACnYQF3MMqv7fqB1UxzjrhS9ys89K-bX-n3XYJQbRq

（编辑：李大同）

【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容!