json c 语言开发指南,JSON_c语言开发指南.doc

JSON c语言开发指南

版本修改记录日期修订人

引言

本文档是基于json-c 库对数据交换进行开发所编写的开发指南，及详细解释json-c库中常用api。 适用于开发人员使用c语言对json的编程。

(注： 此文档json-c库版本为0.8——json-c-0.8)

JSON简介

JSON(JavaScript Object Notation) 是一种轻量级的数据交换格式。易于人阅读和编写。同时也易于机器解析和生成。它基于JavaScript Programming Language, Standard ECMA-262 3rd Edition - December 1999的一个子集。 JSON采用完全独立于语言的文本格式，但是也使用了类似于C语言家族的习惯(包括C, C++, C#, Java, JavaScript, Perl, Python等)。这些特性使JSON成为理想的数据交换语言。

跟XML相比，JSON的优势在于格式简洁短小，特别是在处理大量复杂数据的时候，这个优势便显得非常突出。从各浏览器的支持来看，JSON解决了因不同浏览器对XML DOM解析方式不同而引起的问题JSON建构于两种结构：

“名称/值”对的集合(A collection of name/value pairs)。不同的语言中，它被理解为对象(object)，纪录(record)，结构(struct)，字典(dictionary)，哈希表(hash table)，有键列表(keyed list)，或者关联数组 (associative array)。

值的有序列表(An ordered list of values)。在大部分语言中，它被理解为数组(array)。 这些都是常见的数据结构。事实上大部分现代计算机语言都以某种形式支持它们。这使得一种数据格式在同样基于这些结构的编程语言之间交换成为可能。

JSON具有以下这些形式：

对象是一个无序的“‘名称/值’对”集合。一个对象以“{”(左括号)开始，“}”(右括号)结束。每个“名称”后跟一个“:”(冒号)；“‘名称/值’ 对”之间使用“,”(逗号)分隔。

数组是值(value)的有序集合。一个数组以“[”(左中括号)开始，“]”(右中括号)结束。值之间使用“,”(逗号)分隔。

值(value)可以是双引号括起来的字符串(string)、数值(number)、true、false、 null、对象(object)或者数组(array)。这些结构可以嵌套。

字符串(string)是由双引号包围的任意数量Unicode字符的集合，使用反斜线转义。一个字符(character)即一个单独的字符串(character string)。

字符串(string)与C或者Java的字符串非常相似。

数值(number)也与C或者Java的数值非常相似。除去未曾使用的八进制与十六进制格式。除去一些编码细节。

Json对象的类型：

json_type_object, “名称/值”对的集合Json对象的值类型

json_type_boolean,

json_type_double,

json_type_int,

json_type_array, “值”的集合

json_type_string

struct json_object * json_object_new_object();

说明：

创建个空的json_type_object类型JSON对象。

struct json_object* json_object_new_boolean(boolean b);

说明：

创建个json_type_boolean值类型json对象

boolean json_object_get_boolean(struct json_object *obj);

说明：

从json对象中boolean值类型得到boolean值

同样：

struct json_object* json_object_new_int(int i)

int json_object_get_int(struct json_object *this)

struct json_object* json_object_new_double(double d)

double json_object_get_double(struct json_object *this)

struct json_object* json_object_new_string(char *s)

char* jso