本文共 4880 字，大约阅读时间需要 16 分钟。
JSON（JavaScript Object Notation, JS 对象简谱）是一种轻量级的数据交换格式。它基于 ECMAScript (欧洲计算机协会制定的js规范)的一个子集，采用完全独立于编程语言的文本格式来存储和表示数据。
JSON 的值可以是对象、数组、数字、字符串或者三个字面值 (false、null、true) 中的一个。值中的字面值必须使用小写。数据由键/值对组成，键值对由逗号分隔；花括号表示对象，方括号表示数组。cJSON 是一个仅由 .h 和 .c 文件组成的 JSON 解析器，由纯 C (ANSI C89) 实现，具有较好的跨平台性。cJSON 采用链表存储结构。
cJSON 库的使用非常简单，只需在项目中包含 cJSON.c 和 cJSON.h 即可。如果在命令行进行链接，则需要添加 -lm 表示链接 math 库。在 Cgi 程序中，cJSON 库采用静态编译的方式。cJSON 的类型定义如下：
#define cJSON_False (1 << 0)#define cJSON_True (1 << 1)#define cJSON_NULL (1 << 2)#define cJSON_Number (1 << 3)#define cJSON_String (1 << 4)#define cJSON_Array (1 << 5)#define cJSON_Object (1 << 6)#define cJSON_IsReference 256#define cJSON_StringIsConst 512
struct cJSON { struct cJSON *next; struct cJSON *prev; struct cJSON *child; int type; char *valuestring; int valueint; double valuedouble; char *string;}; 节点数据结构为双向链表，其中 string 为结点的 key，child 指向数组或对象的子节点。
以下是 cJSON 的一些常用方法：
extern void cJSON_InitHooks(cJSON_Hooks* hooks);extern cJSON *cJSON_Parse(const char *value);extern char *cJSON_Print(const cJSON *item);extern char *cJSON_PrintUnformatted(const cJSON *item);extern char *cJSON_PrintBuffered(const cJSON *item, int prebuffer, int fmt);extern void cJSON_Delete(cJSON *c);extern int cJSON_GetArraySize(const cJSON *array);extern cJSON *cJSON_GetArrayItem(const cJSON *array, int item);extern cJSON *cJSON_GetObjectItem(const cJSON *object, const char *string);extern int cJSON_HasObjectItem(cJSON *object, const char *string);extern const char *cJSON_GetErrorPtr();
以下是一些构造 JSON 的 API：
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);
以下是构造数组的 API：
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);
以下是数组操作的 API：
extern void cJSON_AddItemToArray(cJSON *array, cJSON *item);extern void cJSON_AddItemToObject(cJSON *object, const char *string, cJSON *item);extern void cJSON_AddItemReferenceToArray(cJSON *array, cJSON *item);extern void cJSON_AddItemReferenceToObject(cJSON *object, const char *string, cJSON *item);
以下是一些判断函数：
CJSON_PUBLIC(cJSON_bool) cJSON_IsInvalid(const cJSON * const item);CJSON_PUBLIC(cJSON_bool) cJSON_IsFalse(const cJSON * const item);CJSON_PUBLIC(cJSON_bool) cJSON_IsTrue(const cJSON * const item);CJSON_PUBLIC(cJSON_bool) cJSON_IsBool(const cJSON * const item);CJSON_PUBLIC(cJSON_bool) cJSON_IsNull(const cJSON * const item);CJSON_PUBLIC(cJSON_bool) cJSON_IsNumber(const cJSON * const item);CJSON_PUBLIC(cJSON_bool) cJSON_IsString(const cJSON * const item);CJSON_PUBLIC(cJSON_bool) cJSON_IsArray(const cJSON * const item);CJSON_PUBLIC(cJSON_bool) cJSON_IsObject(const cJSON * const item);CJSON_PUBLIC(cJSON_bool) cJSON_IsRaw(const cJSON * const item);
#include#include #include "cJSON.h"char text[] = "{\"timestamp\":\"2019-03-03 08:45:57\", \"value\":1}";int main(int argc, const char *argv[]) { cJSON *json, *json_value, *json_timestamp; json = cJSON_Parse(text); if (json == NULL) { printf("Error before: [%s]\n", cJSON_GetErrorPtr()); return -1; } json_value = cJSON_GetObjectItem(json, "value"); if (json_value->type == cJSON_Number) { printf("value: %d\n", json_value->valueint); } json_timestamp = cJSON_GetObjectItem(json, "timestamp"); if (json_timestamp->type == cJSON_String) { printf("%s\n", json_timestamp->valuestring); } cJSON_Delete(json); return 0;}
#include#include #include "cJSON.h"int main(void) { char *cjson_str = NULL; cJSON *root = cJSON_CreateObject(); cJSON *item = cJSON_CreateObject(); cJSON *next = cJSON_CreateObject(); cJSON_AddItemToObject(root, "rc", cJSON_CreateNumber(0)); cJSON_AddItemToObject(root, "operation", cJSON_CreateString("CALL")); cJSON_AddItemToObject(root, "service", cJSON_CreateString("telephone")); cJSON_AddItemToObject(root, "text", cJSON_CreateString("打电话给张三")); cJSON_AddItemToObject(root, "semantic", item); cJSON_AddItemToObject(item, "slots", next); cJSON_AddItemToObject(next, "name", cJSON_CreateString("张三")); cJSON_AddStringToObject(next, "number", "13423452334"); cJSON_AddNumberToObject(next, "age", 35); cJSON_AddBoolToObject(next, "man", 1); cjson_str = cJSON_Print(root); printf("first json:\n%s\n", cjson_str); free(cjson_str); cJSON_Delete(root); return 0;}
转载地址：http://bjtwz.baihongyu.com/