cJSON库的使用（一）

在c语言里用到json格式的字符串，拼接起来就很麻烦，如果数据大，需要申请空间，如果中间要再插入一个子项，还需要麻烦的拷贝拼接。用cJSon库的好处就是：

1、拼接、插入方便。临时增加，修改，直接用对于的接口来实现，快速，方便。
2、空间申请问题由接口底层去实现。如果拼接很多，内存问题我们不用去过多考虑，只要知道怎么用就可以避免内存泄露问题。
3、格式统一。书写方便，可能有些地方会加中括号，有些没有。用这个可以省掉这种麻烦。
4、使用拓展方便。需要临时增加，或者再加入内容，比较便捷，高效。不用再自己用一大串的转义符加双引号来拼接了。

1、JSON格式：一对大括号，相当于XML的头和尾，内部全是键值对

{
    "name" : "apple"，
    "sex"  : "famale"，
    "high" : "178"，
    "girls":["alice", "ruby", "kit"]，
    "家电" :{"TV":"changhong"}
}

注：结合JSON视图工具，可以把JSON数据结构化展示出来，清晰明了

1、一对大括号括起内容
2、内部使用key:value 
    key值为字符串
    value值可以取值：字符串、数值类型、数组类型[]、对象{}、NULL、布尔值

2、cJSON库

在GitHub上下载对应的cJSON库(cJson-master),注：解码后内部只有cJSON.h和cJSON.c可以供我们使用，也就是直接使用cJSON的源码，用时把这两个文件拷到开发目录下即可

/*内部函数简介：*/
1、cJson_Parse(char*)  //用于解析利用C字符串存储的json字符串
    会生成一个cJSON格式的结构体
2、cJson_Print(cJson*) //用于输出json字符串解析后的数据
    把cJSON结构体转换成C字符串
3、cJson_Delete(cJson*)//释放cJson*类型数据

简单使用：

#include <stdio.h>
#include <stdlib.h>
#include "cJSON.h"

int main(void)
{
	char *data = "{\"love\":[\"LOL\", \"Go shopping\"]}";
	//解析data字符串，存储成cJSON结构体
	cJSON *json = cJSON_Parse(data);
	char *json_data = NULL;
	printf("data : %s\n", json_data = cJSON_Print(json));
	free(json_data);
	cJSON_Delete(json);
	return 0;
}

注：测试文件需要使用数学库，需要加入-lm

加数学库：-lm
注：不是-lmath
floor:向下取整
ceil:向上取整

3、基于JSON相关的C库函数，生成对应的json文件

注：快捷方式：[ + d：快速列出宏定义

<1>创建一个值类型的数据

注：不管什么类型的数据转换后都是cJSON结构体

extern cJSON* cJSON_CreateNumber(double num)
extern cJSON* cJSON_CreateString(const char *string)
extern cJSON* cJSON_CreateArray(void)

<2>创建一个对象(文档)

extern cJSON* cJSON_CreateObject(void); //创建json对象，相当于创建了一对{}

<3>数组创建及添加

cJSON* cJSON_CreateIntArray(const int *numbers, int count)
void cJSON_AddItemToArray(cJSON *array, cJSON *item)
//例子
cJSON* array = NULL;
cJSON_AddItemToArray(array, cJSON_CreateString("LOL"));
cJSON_AddItemToArray(array, cJSON_CreateString("NBA"));
cJSON_AddItemToArray(array, cJSON_CreateString("Shopping"));

4、JSON嵌套

<1>向对象中增加键值对

cJSON_AddItemToObject(root, "rows", 值数据类型的相关函数());

<2>在对象中增加数组

cJSON_AddItemToObject(root, "rows", cJSON_CreateArray());

<3>向数组中增加对象

cJSON_AddItemToArray(rows, cJSON_CreateObject());

<4>几个可以提高操作效率的宏函数

#define cJSON_AddNumberToObject(object, name, n) \
            cJSON_AddItemToObject(object, name, cJSON_CreateNumber(n))
#define cJSON_AddStringToObject(object, name, s) \
            cJSON_AddItemToObejct(object, name, cJSON_CreateString(s))

<5>添加一个元素到json对象中：cJSON_AddItemToObject(json, "key", value)

value取值：
    字符串   ---》cJSON_CreateString("value");
    数值     ---》cJSON_CreateNumber(29);
    数组     ---》cJSON_CreateArray(void);
    对象     ---》cJSON_CreateObject(void);

5、json文件创建方法

    ----》json = cJSON_CreateObject(); //相当于创建一个大括号
    ----》cJSON_AddItemToObject(json, "name", cJSON_CreateString("hmh")) //json对象加元素
{    
    "name":"hmh", ---->cJSON_CreateString("hmh")
    "age":28,
}

6、创建json文件案例

注：gcc -o demo test2.c cJSON.* -lm

#include <stdio.h>
#include <string.h>
#include <stdlib.h>
#include "cJSON.h"
int main(void)
{
	//创建一个空的文档对象
	cJSON* json = cJSON_CreateObject();

	//向文档中增加一个键值对{"name":"hmh"}
	//======>cJSON_AddStringToObject(json, "name", "hmh")
	cJSON_AddItemToObject(json, "name", cJSON_CreateString("hmh"));
	cJSON_AddItemToObject(json, "age", cJSON_CreateNumber(29));

	cJSON* array = NULL;
	cJSON_AddItemToObject(json, "love", array = cJSON_CreateArray());
	cJSON_AddItemToArray(array, cJSON_CreateString("LOL"));
	cJSON_AddItemToArray(array, cJSON_CreateString("NBA"));
	cJSON_AddItemToArray(array, cJSON_CreateString("Shopping"));

	//宏的使用
	cJSON_AddNumberToObject(json, "score", 59);
	cJSON_AddStringToObject(json, "address", "beijing");

	//将json结构体格式化到缓冲区
	char *buf = cJSON_Print(json);

	//打开文件用以写入json数据
	FILE *fp = fopen("test2.json", "w");
	fwrite(buf, 1, strlen(buf), fp);
	free(buf);
	fclose(fp);

	//释放json结构体所占的内存
	cJSON_Delete(json);
	
	return 0;
}

7、特别注意

在上面我们对cJSON进行了一些简单分析，包括解析、打包这两种最常用功能，cJSON的移植相对简单，但是在使用的时候，还是有一些特别需要注意的地方的，这 主要是因为 cJSON库 中的一些函数会进行内存申请操作，但是并不会自动释放内存，这就相当于 是风险， 需要使用者自己去及时的释放 内存。如果处理不当，会造成内存用完，进而程序也运行不了多久就废掉了。所以需要特别注意的地方：

（1）使用cJSON_Parse创建一个 cJSON指针后，用完务必 使用 cJSON_Delete函数释放 该cJSON指针。

（2）使用cJSON_Createxxx函数创建 json对象后， 用完务必使用 cJSON_Delete函数释放 该cJSON指针。

（3）使用 cJSON_Print函数 将cJSON数据 解析成 char 字符串后，务必使用 cJSON_free函数释放 该char指针，这个 细节隐藏的很深，因为cJSON_Print 函数不光是 print打印，他会 调用cJSON_malloc 申请内存，所以用完 必须要释放 掉 该char 指针。

cJSON_Delete(root);    //非常重要！！！！！！
CJSON_free(payload);   //非常重要！！！！！！