【C】JSON及cJSON介绍

1. JSON简介

JSON(JavaScriptObject Notation, JS 对象标记) 是一种轻量级的数据交换格式。它是基于 ECMAScript (w3c制定的js规范)的一个子集，采用完全独立于编程语言的文本格式来存储和表示数据。简洁和清晰的层次结构使得 JSON 成为理想的数据交换语言。 易于人阅读和编写，同时也易于机器解析和生成，并有效地提升网络传输效率。

如Figure1以及Figure2所示为JSON结构，JSON的结构主要是由key-value键值对所组成的，其中可以使用结构体或者数组来组织key-value键值对。在JSON结构中，同一级的key-value键值对使用逗号“，”隔开，每个key-value键值对是由一个key后面紧接冒号“：”，冒号后面是这个key对应的value。key和C语言中变量的命名相似，由大小写字母、下划线及数字组成，可以由双引号封闭，也可以不用双引号，一般建议要有意义，即看到key，明白是要表示什么。value的取值可以为number、boolean(true、false)、null、string、object和array。另外，JSON支持嵌套，即一个JSON格式中，允许再嵌套一个JSON格式的数据。

Figure1 JSON exampl1

Figure2 JSON exmaple2

       在PHD、JS以及Java等编程语言中，JSON的生成对比于C语言来说，显得要非常简单，但是根据JSON的结构特点，也是可以使用C语言来实现的，下面介绍一种使用C语言实现JSON格式的使用方法——cJSON。

2. cJSON介绍

cJSON是一个超轻巧，携带方便，单文件，简单的可以作为ANSI-C标准的JSON解析器。 其代码的github链接参考【1】，其中主要包括两个文件cjson.c以及cjson.h，其中cjson.h文件中包含了对于JSON格式的结构体定义以及一些操作JSON格式的功能函数，包括创建JSON、向JSON格式中添加数字，字符，布尔值等等、读取JSON格式、将JSON格式转化为字符串等，而cjson.c中就是功能函数的具体实现，以下简单介绍一下cJSON结构体中的内容，Figure 3为cJSON结构体的声明：

Figure3 cJSON structure

cJSON结构体的解释

       （a）struct cJSON *next;     // 指向下一项；

       （b）struct cJSON *pre;       // 指向上一项；

       （c）struct cJSON *child;    // 指向下一级，也就是当type为cJSON_Object或cJSON_Array时，此指针不为空；

       （d）int type;                       //元素的类型，Figure 4是cJSON type的定义；

       （e）char *valuestring;     // 如果元素类型是cJSON_String，那么元素的值可以从这里读取；

       （f）int valueint;                 //如果元素类型为 cJSON_Number并且是整型数据，那么元素的值就等于valueint；

       （g）double valuedouble；  // 如果元素类型为 cJSON_Number并且是浮点型数据，那么元素的值就等于valuedouble；

（h）char *string;                // 当前项的名称，也就是key-value键值对的key

Figure4 cJSON Type

关于cJSON的使用，可以参考下一篇博客！

3.      Reference

【1】       https://github.com/DaveGamble/cJSON cJSON的github链接

【2】       http://www.cnblogs.com/kuikui/p/3176806.html  JSON介绍

【3】       http://www.oracle.com/technetwork/cn/topics/entarch/introduction-json-096920-zhs.html?ssSourceSiteId=otnen JSON简介

【4】       http://blog.csdn.net/xukai871105/article/details/32346797JSON格式详解

【5】       http://blog.csdn.net/xukai871105/article/details/17094113cJSON学习笔记