【cJSON】CJSON学习笔记（二）

1.重要函数说明

【1】两个创建

【创建JSON对象】cJSON *cJSON_CreateObject(void);

【创建JSON数组】cJSON *cJSON_CreateArray(void);

【2】两种添加

【向对象中添加】voidcJSON_AddItemToObject(cJSON *object,const char *string,cJSON *item);

【向数组中添加】void cJSON_AddItemToArray(cJSON *array, cJSON *item);

【3】常用几招

【向对象中增加数字】cJSON_AddItemToObject(root, "value", cJSON_CreateNumber(value));

【向对象中增加文件】cJSON_AddItemToObject(root, "string", cJSON_CreateString(string));

【4】JSON嵌套

【向对象中增加数组】cJSON_AddItemToObject(root, "rows", rows = cJSON_CreateArray());

【向数组中增加对象】cJSON_AddItemToArray(rows, row = cJSON_CreateObject());

2.创建各种各样的JSON数据包

在这里通过代码举几个例子，更多的内容请查看代码仓库中的相关文件。

【1】JSON数字

[cpp] view
plaincopy





void create_single_number(void) {

cJSON *root;

char *out;

int value = 24;

root = cJSON_CreateObject(); // 创建根

cJSON_AddItemToObject(root, "value", cJSON_CreateNumber(value));

// 打印并释放

out = cJSON_Print(root); cJSON_Delete(root); printf("%s\n",out); free(out);

// 控制台输出

#if 0

{

"value": 24

}

#endif

}

【简单说明】

【1】cJSON_AddItemToObject(root, "value", cJSON_CreateNumber(value));

【2】cJSON_AddNumberToObject(root, "value", value);

【1】和【2】效果完全相同。

【2】JSON字符串

[cpp] view
plaincopy





void create_single_string(void) {

cJSON *root;

char *out;

char *name = "xukai871105";

root = cJSON_CreateObject(); // 创建根

// 方法 使用cJSON_AddItemToObject，推荐使用

cJSON_AddItemToObject(root, "name", cJSON_CreateString(name));

// 打印并释放

out = cJSON_Print(root); cJSON_Delete(root); printf("%s\n",out); free(out);

// 控制台输出

#if 0

{

"name": "xukai871105"

}

#endif

}

【简单说明】

【1】 cJSON_AddItemToObject(root, "name", cJSON_CreateString(name));

【2】 cJSON_AddStringToObject(root, "name",name);

【1】和【2】效果完全相同。

【3】JSON布尔类型

[cpp] view
plaincopy





void create_bool(void) {

cJSON *root;

char *out;

root = cJSON_CreateObject(); // 创建根

cJSON_AddItemToObject(root, "success", cJSON_CreateFalse());

// 打印并释放

out = cJSON_Print(root); cJSON_Delete(root); printf("%s\n",out); free(out);

// 控制台输出

#if 0

{

"success": false

}

#endif

}

【简单说明】

【1】布尔类型不需要加引号。

3.JSON格式嵌套

JSON格式在使用时往往存在嵌套，例如JSON对象中嵌套JSON数组而JSON数组中嵌套JSON对象，下面就通过几个简单的例子说明问题。

【1】JSON简单嵌套

[cpp] view
plaincopy





void create_simple(void) {

cJSON *root;

char *out;

int list[4] = {5,6,7,8};

root = cJSON_CreateObject(); // 创建根

cJSON_AddItemToObject(root, "lists", cJSON_CreateIntArray(list, 4));

// 打印并释放

out = cJSON_Print(root); cJSON_Delete(root); printf("%s\n",out); free(out);

// 控制台输出

#if 0

{

"lists": [5, 6, 7, 8]

}

#endif

}

【2】JSON复杂嵌套

[cpp] view
plaincopy





void create_complex(void) {

cJSON *root, *rows, *row;

char *out;

int i = 0;

char *title[3] = { "树莓派学习笔记——索引博文",

"树莓派学习笔记——GPIO功能学习",

"物联网学习笔记——索引博文"};

char *url[3] = { "http://blog.csdn.net/xukai871105/article/details/23115627",

"http://blog.csdn.net/xukai871105/article/details/12684617",

"http://blog.csdn.net/xukai871105/article/details/23366187"};

root = cJSON_CreateObject(); // 创建根

cJSON_AddNumberToObject(root, "total", 3);

// 在object中加入array

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

for(i = 0; i < 3; i++) {

// 在array中加入object

cJSON_AddItemToArray(rows, row = cJSON_CreateObject());

cJSON_AddItemToObject(row, "title", cJSON_CreateString(title[i]));

cJSON_AddItemToObject(row, "url", cJSON_CreateString(url[i]));

}

// 打印并释放

out = cJSON_Print(root); cJSON_Delete(root); printf("%s\n",out); free(out);

// 控制台输出

#if 0

{

"total": 3,

"rows": [{

"title": "树莓派学习笔记——索引博文",

"url": "http://blog.csdn.net/xukai871105/article/details/23115627"

}, {

"title": "树莓派学习笔记——GPIO功能学习",

"url": "http://blog.csdn.net/xukai871105/article/details/12684617"

}, {

"title": "物联网学习笔记——索引博文",

"url": "http://blog.csdn.net/xukai871105/article/details/23366187"

}]

}

#endif

}

【简单说明】

rows为JSON对象，rows对象中嵌套JSON数组，每一个JSON数组的元素又是一个JSON对象，该该对象名为row，row对象中具有两个键值对，分别是titile和url。

2015/08/19 17:50

【其他参考示例】

1. 函数的使用

宏的定义原型：
/* Macros for creating things quickly. */
#define cJSON_AddNullToObject(object,name) cJSON_AddItemToObject(object, name, cJSON_CreateNull())
#define cJSON_AddTrueToObject(object,name) cJSON_AddItemToObject(object, name, cJSON_CreateTrue())
#define cJSON_AddFalseToObject(object,name) cJSON_AddItemToObject(object, name, cJSON_CreateFalse())
#define cJSON_AddBoolToObject(object,name,b) cJSON_AddItemToObject(object, name, cJSON_CreateBool(b))
#define cJSON_AddNumberToObject(object,name,n) cJSON_AddItemToObject(object, name, cJSON_CreateNumber(n))
#define cJSON_AddStringToObject(object,name,s) cJSON_AddItemToObject(object, name, cJSON_CreateString(s))

示例：
cJSON *root = cJSON_CreateObject(); //先创建一个对象
cJSON_AddNumberToObject(root, "value", 123.4);
cJSON_AddStringToObject(root, "year", "2015");
cJSON_AddNullToObject(root, "secret");
cJSON_AddTrueToObject(root, "Bool");
cJSON_AddFalseToObject(root, "false");
cJSON_AddBoolToObject(root, "Yes", 3);
cJSON_AddBoolToObject(root, "Yes", 0);
out = cJSON_Print(root); //打印对象
//out = cJSON_PrintUnformatted(root); //非格式化的打印
//printf("===> 2: %s\n", out);
printf("%s\n", out);
cJSON_Delete(root); //释放对象所占的内存
free(out);

函数的原型：
/* These calls create a cJSON item of the appropriate type. */
extern cJSON *cJSON_CreateNull(void);
extern cJSON *cJSON_CreateTrue(void);
extern cJSON *cJSON_CreateFalse(void);
extern cJSON *cJSON_CreateBool(int b);
extern cJSON *cJSON_CreateNumber(double num);
extern cJSON *cJSON_CreateString(const char *string);
extern cJSON *cJSON_CreateArray(void);
extern cJSON *cJSON_CreateObject(void);

示例：参考上面博客的代码

函数原型：
/* These utilities create an Array of count items. */
extern cJSON *cJSON_CreateIntArray(const int *numbers,int count);
extern cJSON *cJSON_CreateFloatArray(const float *numbers,int count);
extern cJSON *cJSON_CreateDoubleArray(const double *numbers,int count);
extern cJSON *cJSON_CreateStringArray(const char **strings,int count);

/* Append item to the specified array/object. */
extern void cJSON_AddItemToArray(cJSON *array, cJSON *item);
extern void cJSON_AddItemToObject(cJSON *object,const char *string,cJSON *item);
extern void cJSON_AddItemToObjectCS(cJSON *object,const char *string,cJSON *item);

示例：
char *out = NULL;
int array[] = {1, 2, 3, 4};
int array1[] = {1, 2, 3, 4, 5, 6};
cJSON *json = NULL;
cJSON *item = NULL;
cJSON *tmp = NULL;

json = cJSON_CreateObject();
//cJSON_AddItemToObject(json,"array", cJSON_CreateIntArray(array, 4)); //与下面两行等价
item = cJSON_CreateIntArray(array, 4);
cJSON_AddItemToObject(json, "array", item);
out = cJSON_Print(json);
printf("%s\n", out);

printf("=========================\n");
printf("size: %d\n", cJSON_GetArraySize(item)); //输出为4 4个元素

tmp = cJSON_GetArrayItem(json, 0); //获取json中的第一个节点
if (NULL != tmp)
{
printf("ok..\n");
printf("size: %d\n", cJSON_GetArraySize(tmp));
}
else
printf("error...\n");

//此时item数组中的元素有 1 2 3 4 5 6 7
printf("=========================\n");
cJSON_AddItemToArray(item, cJSON_CreateNumber(5));
cJSON_AddItemToArray(item, cJSON_CreateNumber(6));
cJSON_AddItemToArray(item, cJSON_CreateNumber(7));
printf("size: %d\n", cJSON_GetArraySize(item));
out = cJSON_Print(json);
printf("%s\n", out);

tmp = cJSON_CreateIntArray(array1, 6);
//cJSON_AddItemToObject(json, "array1", tmp); //好像与下面一句话等价呢
cJSON_AddItemReferenceToObject(json, "array1", tmp);
out = cJSON_Print(json);
printf("%s\n", out);

//整形数组的参考示例
int array3[] = {1, 3, 5, 7, 9};

json = cJSON_CreateIntArray(array3, 5);

out = cJSON_Print(json); cJSON_Delete(json); printf("%s\n", out);
free(out);

//字符指针数组
const char *strings[7]={"Sunday","Monday","Tuesday","Wednesday","Thursday","Friday","Saturday"};
json = cJSON_CreateStringArray(strings, 7);
out = cJSON_Print(json); cJSON_Delete(json); printf("%s\n",
out); free(out);

参考博客：http://blog.csdn.net/xukai871105/article/details/33013455