cjson使用基础

一、cJSON简介：

JSON(JavaScriptObject Notation)是一种轻量级的数据交换格式。它基于JavaScript的一个子集。JSON采用完全独立于语言的文本格式，但是也使用了类似于C语言家族的习惯。这些特性使JSON成为理想的数据交换语言。易于人阅读和编写，同时也易于机器解析和生成。

cJSON是一个超轻巧，携带方便，单文件，简单的可以作为ANSI-C标准的JSON解析器。

cJSON结构体：

typedefstruct cJSON {

structcJSON *next,*prev;

struct cJSON *child;

int type;

char * valuestring;

int valueint;

double valuedouble;

char *string;

}cJSON;

1、cJSON存储的时候是采用链表存储的，其访问方式很像一颗树。每一个节点可以有兄妹节点，通过next/prev指针来查找，它类似双向链表；每个节点也可以有孩子节点，通过child指针来访问，进入下一层。

不过，只有节点是对象或数组才可以有孩子节点。

2、type一共有7种取值，分别是：

#define cJSON_False 0

#define cJSON_True 1

#define cJSON_NULL 2

#define cJSON_Number 3

#define cJSON_String 4

#define cJSON_Array 5

#define cJSON_Object 6

若是Number类型，则valueint或valuedouble中存储着值，若你期望的是int，则访问valueint，若期望的是double，则访问valuedouble，可以得到值。

若是String类型的，则valuestring中存储着值，可以访问valuestring得到值。

3、string中存放的是这个节点的名字。

4、用法：

   （1）、只需在函数中includecJSON.h头文件，然后和cJSON.c或库文件libcJSON.a一起编译即可使用。

   （2）、具体函数用法详见cJSON.h中注释

我使用的是cJSON:http://sourceforge.net/projects/cjson/ 先看json的数据结构 c中没有对象，所以json数据是采用链表存储的 

[cpp]  view plain copy

1. typedef struct cJSON {  
2.     struct cJSON *next,*prev;   // 数组 对象数据中用到  
3.     struct cJSON *child;        // 数组 和对象中指向子数组对象或值  
4.   
5.     int type;           // 元素的类型，如是对象还是数组  
6.   
7.     char *valuestring;          // 如果是字符串  
8.     int valueint;               // 如果是数值  
9.     double valuedouble;         // 如果类型是cJSON_Number  
10.   
11.     char *string;               // The item's name string, if this item is the child of, or is in the list of subitems of an object.  
12. } cJSON; 
    

二、 cJSON常用函数简介

cJSON * cJSON_CreateObject();

创建一个json对象，返回一个cJSON结构体类型的指针。

cJSON *cJSON_CreateArray();

创建一个数组对象，返回一个cJSON结构体类型的指针。

cJSON *cJSON_CreateString(const char *string);

创建一个字符串对象，传入一个char *类型的字符串，返回一个cJSON结构体类型的指针。

void cJSON_AddItemToArray(cJSON *array, cJSON *item);

向数组对象中添加一个元素，传入参数array为cJSON *结构体类型的指针，为数组对象; item为添加入数字对象中的对象指针。

void cJSON_AddItemToObject(cJSON *object,const char *string,cJSON *item);

向json对象中添加一对元素，object为json对象，string为加入一对元素中的name，item为加入一对元素中的value。

cJSON *cJSON_Parse(const char *value);

解析一个json串，传入一个json格式的字符串，返回一个cJSON *类型的结构体指针。

char  *cJSON_Print(cJSON *item);

将一个cJSON结构体代表的json对象转换为一个json格式的字符串。

void   cJSON_Delete(cJSON *c);

释放一个cJSON对象所占用的内存空间。

三、应用举例

1.json字符串解析
 比如你有一个json数据 

[javascript]  view plain copy

1. {  
2.     "name": "Jack (\"Bee\") Nimble",   
3.     "format": {  
4.         "type":       "rect",   
5.         "width":      1920,   
6.         "height":     1080,   
7.         "interlace":  false,   
8.         "frame rate": 24  
9.     }  
10. }  

(1)、将字符串解析成json结构体。 

[cpp]  view plain copy

1. cJSON *root = cJSON_Parse(my_json_string); 
   

(2)、获取某个元素 

[cpp]  view plain copy

1. cJSON *format = cJSON_GetObjectItem(root,"format");  
2. int framerate = cJSON_GetObjectItem(format,"frame rate")->valueint; 
   

(3)、将json结构体转换成字符串 、

[cpp]  view plain copy

1. char *rendered=cJSON_Print(root);  

（4）、删除 json结构体

[cpp]  view plain copy

1. cJSON_Delete(root);  

2.构建json文件

(1)、构建一个json结构体 

[cpp]  view plain copy

1. cJSON *root,*fmt;  
2. root=cJSON_CreateObject();    
3. cJSON_AddItemToObject(root, "name", cJSON_CreateString("Jack (\"Bee\") Nimble"));  
4. cJSON_AddItemToObject(root, "format", fmt=cJSON_CreateObject());  
5. cJSON_AddStringToObject(fmt,"type",     "rect");  
6. cJSON_AddNumberToObject(fmt,"width",        1920);  
7. cJSON_AddNumberToObject(fmt,"height",       1080);  
8. cJSON_AddFalseToObject (fmt,"interlace");  
9. cJSON_AddNumberToObject(fmt,"frame rate",   24);  

（2）、将json结构体转换成字符串

[cpp]  view plain copy

1. char *rendered=cJSON_Print(root); 
   

（3）、写json文件

[cpp]  view plain copy

1. FILE *fp = NULL;
2. fp = fopen(filename, “w”);
3. fwrite(str, strlen(str), 1, fp);
4. fclose(fp);