cJSON解析器总结
一. 简介
cJson 是c语言编写的一个解析器. 是一个超轻巧,携带方便,单文件,简单的可以作为ANSI-C标准的JSON解析器。主要两个文件cJSON.c 和cJSON.h . 主要用来编码和解析数据.
其中,定义了一个cJSON的数据结构,用来储存数据.是以链表的形式.结构体如下:
在.h文件下
typedef struct cJSON {
struct cJSON *next,*prev; //双向链表
struct cJSON *child; //指向字节点,主要是在数组结构中用
int type; //类型,有7种类型,也就是说可以储存7种形式数据
//分别为：
1. cJSON_False
2. cJSON_True
3. cJSON_NULL
4. cJSON_Number
5. cJSON_String
6. cJSON_Array
7. cJSON_Object
char *valuestring; // 如果类型为cJSON_String 时用来存那个字符串
int valueint; //如果类型为cJSON_Number 时用来存值 ,这个主要存int型,如果是小数会有类型转换
double valuedouble; //这个存浮点数,如果是整数也会转换为浮点型,和valueint一起存同一个数据
char *string; //用来存字节点名字.主要是object时用.
} cJSON;
二. 把数据组织成结构（也就是节点组成结构）
下面的函数来产生各种类型的节点.
extern cJSON *cJSON_CreatNULL(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);
这些函数主要是把类型type写入节点,并且把相关的值也写入节点.比如创造字符串节点函数,还要把字符串指针valuestring指向相应字符串.
下面的函数创造数组节点集.也就是先创建一个数组类型的节点(用cJSON_CreateArray(void)函数 ),再把number数组的数据分别放在一个结点中(比如一个个int型数据的节点),并链表串起来(用suffix_object()函数).最后都悬挂在数组节点的字节点上(也就是结构体中的child指针指向它们),最后的最后返回数组的指针.
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);
下面图例一个说明创建一个数型数组的过程：
三. 打包结构数据
组织好数据后就要已一定的格式把结构组织成字符串,便于传递. 使用函数:
extern char *cJSON_Print(cJSON *item);
extern char *cJSON_PrintUnformatted(cJSON *item);
说明:
如例子:
out=cJSON_Print(root); 就把结构root以一定的方式打包成字符串out.
分析一下打印的方式:
两种打印方式: 有格式和无格式两种;
cJSON_Print(root); 内部调用print_value(item,0, 1),而cJSON_PrintUnformatted(cJSON *item);内部调用print_value(item,0,0),
而print_value()函数里面分情况解析如下:
switch ((item->type)&255)
{
case cJSON_NULL: out=cJSON_strdup("null"); break;
case cJSON_False: out=cJSON_strdup("false");break;
case cJSON_True: out=cJSON_strdup("true"); break;
case cJSON_Number: out=print_number(item);break;
case cJSON_String: out=print_string(item);break;
case cJSON_Array: out=print_array(item,depth,fmt);break;
case cJSON_Object: out=print_object(item,depth,fmt);break;
}
所以对于数值, 字符串, 数组和object来说 ,又有各自的函数print_number和print_string 函数就是以一定方式储存成字符串.而 print_array 和 print_object 函数又是对上两个函数的封装.
一般再调用函数删除前面的结构:
extern void cJSON_Delete(cJSON *c);
如例子:
cJSON_Delete(root);
这样就把数据彻底打包完成,可以传递或储存了.
四. 解析,还原结构
其中有几个辅助函数,先介绍一下:
//得到数组的长度,也就是子节点的个数.
extern int cJSON_GetArraySize(cJSON *array);
//得到数组的第item个节点.
extern cJSON *cJSON_GetArrayItem(cJSON *array,int item);
//得到名为string的节点.
extern cJSON *cJSON_GetObjectItem(cJSON *object,const char *string);
解析采用分层解析的形式,一步一步解到最后一层.
和打印的方式一样,打印是:如果是数组或object , 则继续向下打印. 直到到子节点, 数值或字符串或其他,然后打印.. 解析应该正好相反. 比如最上层是数组, 那么先解析数组,然后得出数组大小, 再得出每一个数组节点, 如果不是最终节点. 还要往下: 先打印这个子节点,再解析,再得出子节点的子节点, 最后打印出来.就是节点的值了.
例子如下:
cJSON * root,*arrayItem,*item,*name,*path,*flag;
int i = 0,size = 0;
char *pr = NULL,*na = NULL,*pa = NULL,*fl = NULL;
//将字符串解析成json结构体
root = cJSON_Parse(out);
//根据结构体获取数组大小
size = cJSON_GetArraySize(root);
//printf("%d\n",size);
//遍历数组
for(i=0;i < size; i++)
{
//获取第i个数组项
arrayItem = cJSON_GetArrayItem(root,i);
if(arrayItem)
{
//printf("%s\n","start......");
//讲json结构体转换成字符串
pr = cJSON_Print(arrayItem);
item = cJSON_Parse(pr);
name = cJSON_GetObjectItem(item,"name");
path = cJSON_GetObjectItem(item,"path");
flag = cJSON_GetObjectItem(item,"flag");
na = cJSON_Print(name);
pa = cJSON_Print(path);
fl = cJSON_Print(flag);
//printf("%s\n",pr);
printf("name:%s\n",na);
printf("path:%s\n",pa);
printf("flag:%s\n\n",fl);
}
}