1. 程式人生 > >cjson 解析json配置文件

cjson 解析json配置文件

原文連結:http://www.linuxidc.com/Linux/2014-05/101822.htm
 
在C或者C++專案中常常需要解析配置檔案,我們常見的配置檔案格式一般就是.ini,xml,lua或者是一般的text檔案,這些格式比較惱人的一個問題就是資料格式過於冗餘,或者功能不夠強大,不支援正則匹配,或者實現解析檔案的程式碼過多,效率不高等等。比較大型的開源專案,比如Nginx,ATS等都有自己比較龐大的配置檔案格式,特別是Nginx,語言十分獨特簡潔,功能強大,但是往往程式碼較為繁雜。那麼有沒有比較簡潔的資料交換格式呢?我想到了web上常用到的json格式,這種檔案格式非常簡潔,而且正在日益成為新的交換格式的標準。為此,我打算在我的專案中使用json作為配置檔案。
 
有沒有一種輕量級的,簡潔夠用的解析實現程式碼,來完成解析json資料的工作呢?
 
這就是下面要介紹的cJSON開源庫。cJSON的網址:http://sourceforge.net/projects/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中存放的是這個節點的名字。
 
用法:
 
1、只需在函式中includecJSON.h標頭檔案,然後和cJSON.c或庫檔案libcJSON.a一起編譯即可使用。
 
2、具體函式用法詳見cJSON.h中註釋。
 
4.主要函式說明
 
extern cJSON *cJSON_Parse(const char *value);//解析一個json字串為cJSON物件
 extern char  *cJSON_Print(cJSON *item);//將json物件轉換成容易讓人看清結構的字串
 extern char  *cJSON_PrintUnformatted(cJSON *item);//將json物件轉換成一個很短的字串,無回車
 extern void  cJSON_Delete(cJSON *c);//刪除json物件
 extern int  cJSON_GetArraySize(cJSON *array);//返回json陣列大小
 extern cJSON *cJSON_GetArrayItem(cJSON *array,int item);//返回json陣列中指定位置物件
 extern cJSON *cJSON_GetObjectItem(cJSON *object,const char *string);//返回指定字串對應的json物件
 extern cJSON *cJSON_CreateIntArray(int *numbers,int count);//生成整型陣列json物件
 extern void cJSON_AddItemToArray(cJSON *array, cJSON *item);//向陣列中新增元素
 

5.使用方法(c語言解析json資料)
 
先看json的資料結構 
 c中沒有物件,所以json資料是採用連結串列儲存的 
 typedef struct cJSON {
  struct cJSON *next,*prev; // 陣列 物件資料中用到
  struct cJSON *child;  // 陣列 和物件中指向子陣列物件或值
 
 int type;  // 元素的型別,如是物件還是陣列
  char *valuestring;  // 如果是字串
  int valueint;    // 如果是數值
  double valuedouble;  // 如果型別是cJSON_Number
 
 char *string;    // The item's name string, if this item is the child of, or is in the list of subitems of an object.
 } cJSON;
 

比如你有一個json資料 
 Javascript程式碼  
 {  
    "name": "Jack (\"Bee\") Nimble",    
    "format": {  
        "type":      "rect",    
        "width":      1920,    
        "height":    1080,    
        "interlace":  false,    
        "frame rate": 24  
    }  
 } 
 
那麼你可以 
 1:講字串解析成json結構體。 
 cJSON *root = cJSON_Parse(my_json_string);
 2:獲取某個元素 
 cJSON *format = cJSON_GetObjectItem(root,"format");
 int framerate = cJSON_GetObjectItem(format,"frame rate")->valueint;
 3:講json結構體轉換成字串 
 char *rendered=cJSON_Print(root);
 4:刪除 
 cJSON_Delete(root);
 5:構建一個json結構體 
 cJSON *root,*fmt;  
 root=cJSON_CreateObject();    
 cJSON_AddItemToObject(root, "name", cJSON_CreateString("Jack (\"Bee\") Nimble"));  
 cJSON_AddItemToObject(root, "format", fmt=cJSON_CreateObject());  
 cJSON_AddStringToObject(fmt,"type",    "rect");  
 cJSON_AddNumberToObject(fmt,"width",        1920);  
 cJSON_AddNumberToObject(fmt,"height",      1080);  
 cJSON_AddFalseToObject (fmt,"interlace");  
 cJSON_AddNumberToObject(fmt,"frame rate",  24);