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;
二. 把数据组织成结构（也就是节点组成结构）
下面的函数来产生各种类型的节点.
1 extern cJSON *cJSON_CreatNULL(void); 2 extern cJSON *cJSON_CreateTrue(void); 3 extern cJSON *cJSON_CreateFalse(void); 4 extern cJSON *cJSON_CreateBool(int b); 5 extern cJSON *cJSON_CreateNumber(double num); 6 extern cJSON *cJSON_CreateString(const char *string); 7 extern cJSON *cJSON_CreateArray(void); 8 extern cJSON *cJSON_CreateObject(void);
这些函数主要是把类型type写入节点,并且把相关的值也写入节点.比如创造字符串节点函数,还要把字符串指针valuestring指向相应字符串.
下面的函数创造数组节点集.也就是先创建一个数组类型的节点(用cJSON_CreateArray(void)函数 ),再把number数组的数据分别放在一个结点中(比如一个个int型数据的节点),并链表串起来(用suffix_object()函数).最后都悬挂在数组节点的字节点上(也就是结构体中的child指针指向它们),最后的最后返回数组的指针.
1 extern cJSON *cJSON_CreateIntArray(const int *numbers,int count); 2 extern cJSON *cJSON_CreateFloatArray(const float *numbers,int count); 3 extern cJSON *cJSON_CreateDoubleArray(const double *numbers,int count); 4 extern cJSON *cJSON_CreateStringArray(const char **strings,int count);
下面图例一个说明创建一个数型数组的过程：
三. 打包结构数据
组织好数据后就要已一定的格式把结构组织成字符串,便于传递. 使用函数:
1 extern char *cJSON_Print(cJSON *item);
2 extern char *cJSON_PrintUnformatted(cJSON *item);
说明:
如例子:
1 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()函数里面分情况解析如下:
1 switch ((item->type)&255) 2 { 3 case cJSON_NULL: out=cJSON_strdup("null"); break; 4 case cJSON_False: out=cJSON_strdup("false");break; 5 case cJSON_True: out=cJSON_strdup("true"); break; 6 case cJSON_Number: out=print_number(item);break; 7 case cJSON_String: out=print_string(item);break; 8 case cJSON_Array: out=print_array(item,depth,fmt);break; 9 case cJSON_Object: out=print_object(item,depth,fmt);break; 10 }
所以对于数值, 字符串, 数组和object来说 ,又有各自的函数print_number和print_string 函数就是以一定方式储存成字符串.而 print_array 和 print_object 函数又是对上两个函数的封装.
一般再调用函数删除前面的结构:
1 extern void cJSON_Delete(cJSON *c);
如例子:
1 cJSON_Delete(root);
这样就把数据彻底打包完成,可以传递或储存了.
四. 解析,还原结构
其中有几个辅助函数,先介绍一下:
1 //得到数组的长度,也就是子节点的个数. 2 extern int cJSON_GetArraySize(cJSON *array); 3 //得到数组的第item个节点. 4 extern cJSON *cJSON_GetArrayItem(cJSON *array,int item); 5 //得到名为string的节点. 6 extern cJSON *cJSON_GetObjectItem(cJSON *object,const char *string);
解析采用分层解析的形式,一步一步解到最后一层.
和打印的方式一样,打印是:如果是数组或object , 则继续向下打印. 直到到子节点, 数值或字符串或其他,然后打印.. 解析应该正好相反. 比如最上层是数组, 那么先解析数组,然后得出数组大小, 再得出每一个数组节点, 如果不是最终节点. 还要往下: 先打印这个子节点,再解析,再得出子节点的子节点, 最后打印出来.就是节点的值了.
例子如下:
1 cJSON * root,*arrayItem,*item,*name,*path,*flag; 2 int i = 0,size = 0; 3 char *pr = NULL,*na = NULL,*pa = NULL,*fl = NULL; 4 //将字符串解析成json结构体 5 root = cJSON_Parse(out); 6 //根据结构体获取数组大小 7 size = cJSON_GetArraySize(root); 8 //printf("%d\n",size); 9 //遍历数组 10 for(i=0;i < size; i++) 11 { 12 //获取第i个数组项 13 arrayItem = cJSON_GetArrayItem(root,i); 14 if(arrayItem) 15 { 16 //printf("%s\n","start......"); 17 //讲json结构体转换成字符串 18 pr = cJSON_Print(arrayItem); 19 item = cJSON_Parse(pr); 20 name = cJSON_GetObjectItem(item,"name"); 21 path = cJSON_GetObjectItem(item,"path"); 22 flag = cJSON_GetObjectItem(item,"flag"); 23 na = cJSON_Print(name); 24 pa = cJSON_Print(path); 25 fl = cJSON_Print(flag); 26 //printf("%s\n",pr); 27 printf("name:%s\n",na); 28 printf("path:%s\n",pa); 29 printf("flag:%s\n\n",fl); 30 } 31 }
————————————————
版权声明：本文为CSDN博主「xz_free」的原创文章，遵循CC 4.0 BY-SA版权协议，转载请附上原文出处链接及本声明。
原文链接：https://blog.csdn.net/ldk_0819/article/details/62215507
