ANSI C中的超轻量级JSON解析器

JSON(JavaScript对象表示法)是一种轻量级的数据交换格式。人类易于阅读和书写。机器很容易解析和生成。它基于JavaScript编程语言标准ECMA-262第三版(1999年12月)的子集 。JSON是一种完全独立于语言的文本格式,但是使用C语言家族(包括C,C ++,C#,Java,JavaScript,Perl,Python等)的程序员熟悉的约定。这些属性使JSON成为理想的数据交换语言。

cJSON旨在成为您可以完成工作的最简单的解析器。它是资源只有一个C的头文件和C文件,所以方便移植。它可以为你各种需要的json字符串处理,包括打包、解析、修改、删除、添加等。在这里将一探究竟。

在这里将着重叙述json的打包和解析,更多处理玩法,见文章末尾链接。

开始cJSON

cJSON合并到您的项目

因为整个库只有一个C文件和一个头文件,所以您只需复制cJSON.h并复制cJSON.c到项目源并开始使用它。

cJSON用ANSI C(C89)编写,以便支持尽可能多的平台和编译器。

下载:

https://github.com/DaveGamble/cJSON/releases

Cjson结构体

/* The cJSON structure: */
typedef struct cJSON
{
struct cJSON *next;
struct cJSON *prev;
struct cJSON *child;
int type;
char *valuestring;
int valueint;
double valuedouble;
char *string;
} cJSON;

结构体项解析:

next 和prev :Cjson结构体作为一个双向连表的环,可以通过 next 和prev 指针进行连表遍历

child:可以是cJSON_Array、cJSON_Object类型数据

type:当前项的类型

valuestring:内容存储,当类型是cJSON_String和cJSON_Raw

valueint:内容存储,整型,可以是cJSON_False、cJSON_True数据

valuedouble:内容存储,浮点型,当类型是cJSON_Number

string:键名

数据类型

l  cJSON_Invalid表示一个不包含任何值的无效项目。如果将项目设置为全零字节,则将自动具有此类型。

l  cJSON_False表示一个false布尔值。您也可以使用来检查布尔值cJSON_IsBool

l  cJSON_True表示一个true布尔值。您也可以使用来检查布尔值cJSON_IsBool

l  cJSON_NULL表示一个null值

l  cJSON_Number 表示一个数字值。该值存储为double in valuedouble和in valueint。如果数字超出整数范围,INT_MAX或INT_MIN用于valueint

l  cJSON_String表示一个字符串值。它以零终止字符串的形式存储在中valuestring

l  cJSON_Array表示一个数组值。这是通过指向表示数组中值child的cJSON项目的链接列表来实现的。使用next和将元素链接在一起prev,其中第一个元素具有prev.next == NULL和最后一个元素next == NULL

l  cJSON_Object 表示一个对象值。对象的存储方式与数组相同,唯一的区别是对象中的项将其键存储在中string

l  cJSON_Raw表示以JSON字符存储的零终止形式的任何JSON valuestring。例如,可以使用它来避免一遍又一遍地打印相同的静态JSON以节省性能。解析时,cJSON永远不会创建此类型。另请注意,cJSON不会检查其是否为有效JSON。

类型

#define cJSON_Invalid (0)
#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_Raw (1 << 7) /* raw json */

类型判断

cJSON_IsInvalid(const cJSON * const item);
cJSON_IsFalse(const cJSON * const item);
cJSON_IsTrue(const cJSON * const item);
cJSON_IsBool(const cJSON * const item);
cJSON_IsNull(const cJSON * const item);
cJSON_IsNumber(const cJSON * const item);
cJSON_IsString(const cJSON * const item);
cJSON_IsArray(const cJSON * const item);
cJSON_IsObject(const cJSON * const item);
cJSON_IsRaw(const cJSON * const item);

注意

创建cjson对象后,处理完需要进行内存释放:

如果是cjson里的对象,请使用cJSON_Delete()

如果不是对象:cJSON_free()或free()

零字符

cJSON不支持包含零字符'\0'或的字符串\u0000。对于当前的API,这是不可能的,因为字符串以零结尾。

字符编码

cJSON仅支持UTF-8编码的输入。但是在大多数情况下,它不会拒绝无效的UTF-8作为输入,而只是将其原样传播。只要输入不包含无效的UTF-8,输出将始终是有效的UTF-8。

C标准

cJSON用ANSI C(或C89,C90)编写。如果您的编译器或C库未遵循此标准,则不能保证正确的行为。

注意:ANSI C不是C ++,因此不应使用C ++编译器进行编译。您可以使用C编译器对其进行编译,然后将其与C ++代码链接。尽管可以使用C ++编译器进行编译,但是不能保证正确的行为。

浮点数字

double除IEEE754双精度浮点数外,cJSON不正式支持任何实现。它可能仍然可以与其他实现一起使用,但是这些实现的错误将被视为无效。

目前,cJSON支持的浮点文字的最大长度为63个字符。

数组和对象的深层嵌套

cJSON不支持嵌套太深的数组和对象,因为这会导致堆栈溢出。为了防止这种CJSON_NESTING_LIMIT情况,默认情况下,cJSON将深度限制为1000,但是可以在编译时进行更改。

格式化输出

按标准的格式输出json字符串,输出完后一定要记得释放内存

代码

 #include <stdio.h>
#include "cJSON.h"
#include "cJSON.c"
void main(){
//待解析字符串
char *json_str="{\"key1\":\"dongxiaodong\",\"key2\":1998,\"key3\":55778}"; //输出原字符串
printf("原字符串:%s\r\n",json_str); //解析成json对象
cJSON * json_obj = cJSON_Parse(json_str); //格式输出
char *json_print_str=NULL;
json_print_str=cJSON_Print(json_obj);
printf("\r\n输出内容:\r\n\r\n%s\r\n",json_print_str); //释放资源
free(json_print_str); //释放资源
cJSON_Delete(json_obj);
}

json打包

cJSON_CreateObject函数可创建一个根数据项,在此之后就可以添加各种数据类型的子节点了,使用完成后需要通过cJSON_Delete()释放内存。

创建一层级的json

代码:

 #include <stdio.h>
#include "cJSON.h"
#include "cJSON.c"
void main(){
cJSON *root_obj = NULL;//根,json对象
char *out_str = NULL; //输出结果
root_obj =cJSON_CreateObject();//创建
//添加一个字符串,参数(根对象,键,值)
cJSON_AddStringToObject(root_obj, "key1", "dongxiaodong");
//添加一个整型,参数(根对象,键,值)
cJSON_AddNumberToObject(root_obj, "key2",);
//添加一个浮点型,参数(根对象,键,值)
cJSON_AddNumberToObject(root_obj, "key3",22.33);
//添加一个bool类型,参数(根对象,键,值)
//bool值可以是0/1或false/true
cJSON_AddBoolToObject(root_obj, "key4",);
//将json对象打包成字符串
out_str = cJSON_PrintUnformatted(root_obj);
//销毁json对象,释放内存
cJSON_Delete(root_obj);
//输出值:{"key1":"dongxiaodong","key2":1998,"key3":22.33,"key4":false}
printf("%s",out_str);
}

类型创建函数还有:

cJSON_AddNullToObject(cJSON * const object, const char * const name);

cJSON_AddTrueToObject(cJSON * const object, const char * const name);

cJSON_AddFalseToObject(cJSON * const object, const char * const name);

cJSON_AddBoolToObject(cJSON * const object, const char * const name, const cJSON_bool boolean);

cJSON_AddNumberToObject(cJSON * const object, const char * const name, const double number);

cJSON_AddStringToObject(cJSON * const object, const char * const name, const char * const string);

cJSON_AddRawToObject(cJSON * const object, const char * const name, const char * const raw);

cJSON_AddObjectToObject(cJSON * const object, const char * const name);

cJSON_AddArrayToObject(cJSON * const object, const char * const name);

创建多层级的json

代码:

 #include <stdio.h>
#include "cJSON.h"
#include "cJSON.c"
void main(){
cJSON *root_obj = NULL;//根,json对象
cJSON *item_obj = NULL;//二级json对象
char *out_str = NULL; //输出结果 root_obj =cJSON_CreateObject();//创建
//添加一个字符串,参数(根对象,键,值)
cJSON_AddStringToObject(root_obj, "key1", "dongxiaodong");
//添加一个整型,参数(根对象,键,值)
cJSON_AddNumberToObject(root_obj, "key2",); //创建一个子json对象
item_obj= cJSON_AddObjectToObject(root_obj,"myson");
//向孩子对象中添加内容
cJSON_AddStringToObject(item_obj, "sonkey1", "东小东");
cJSON_AddNumberToObject(item_obj, "sonkey2",); //将json对象打包成字符串
out_str = cJSON_PrintUnformatted(root_obj);
//销毁json对象,释放内存
cJSON_Delete(root_obj);
//输出值:{"key1":"dongxiaodong","key2":1998,"myson":{"sonkey1":"东小东","sonkey2":2020}}
printf("%s",out_str);
}

创建多层json(数组形式)

代码

 #include <stdio.h>
#include "cJSON.h"
#include "cJSON.c"
void main(){
cJSON *root_obj = NULL;//根,json对象
cJSON *item_obj = NULL;//数组对象
char *out_str = NULL; //输出结果 root_obj =cJSON_CreateObject();//创建
//添加一个字符串,参数(根对象,键,值)
cJSON_AddStringToObject(root_obj, "key1", "dongxiaodong");
//添加一个整型,参数(根对象,键,值)
cJSON_AddNumberToObject(root_obj, "key2",); //创建一个子数组对象
item_obj= cJSON_AddArrayToObject(root_obj,"myson");
//向数组对象中添加内容
cJSON_AddItemToArray(item_obj,cJSON_CreateTrue());
cJSON_AddItemToArray(item_obj,cJSON_CreateNumber()); //将json对象打包成字符串
out_str = cJSON_PrintUnformatted(root_obj);
//销毁json对象,释放内存
cJSON_Delete(root_obj);
//输出值:{"key1":"dongxiaodong","key2":1998,"myson":[true,22]}
printf("%s",out_str);
}

创建的对象还可以是下面这些

cJSON_CreateNull(void);

cJSON_CreateTrue(void);

cJSON_CreateFalse(void);

cJSON_CreateBool(cJSON_bool boolean);

cJSON_CreateNumber(double num);

cJSON_CreateString(const char *string);

cJSON_CreateRaw(const char *raw);

cJSON_CreateArray(void);

cJSON_CreateObject(void);

创建混合json

代码

 #include <stdio.h>
#include "cJSON.h"
#include "cJSON.c"
void main(){
cJSON *root_obj = NULL;//根,json对象
cJSON *son_obj=NULL;
cJSON *item_obj = NULL;//数组对象
char *out_str = NULL; //输出结果 //根对象
root_obj =cJSON_CreateObject();//创建
//添加一个字符串,参数(根对象,键,值)
cJSON_AddStringToObject(root_obj, "key1", "dongxiaodong");
//添加一个整型,参数(根对象,键,值)
cJSON_AddNumberToObject(root_obj, "key2",); //创建一个子数组对象
item_obj= cJSON_AddArrayToObject(root_obj,"myson");
//向数组对象中添加内容
cJSON_AddItemToArray(item_obj,cJSON_CreateTrue());
cJSON_AddItemToArray(item_obj,cJSON_CreateNumber()); //子对象
son_obj =cJSON_CreateObject();//创建
//添加一个字符串,参数(根对象,键,值)
cJSON_AddStringToObject(son_obj, "son1", "dongxiaodong");
//添加一个整型,参数(根对象,键,值)
cJSON_AddNumberToObject(son_obj, "son2",);
cJSON_AddItemToArray(item_obj,son_obj); //将json对象打包成字符串
out_str = cJSON_PrintUnformatted(root_obj);
//销毁json对象,释放内存
cJSON_Delete(root_obj);
//输出值:{"key1":"dongxiaodong","key2":1998,"myson":[true,22,{"son1":"dongxiaodong","son2":1998}]}
printf("%s",out_str);
}

json解析

解析一层级的json

代码:

 #include <stdio.h>
#include "cJSON.h"
#include "cJSON.c"
void main(){
//待解析字符串
char *json_str="{\"key1\":\"dongxiaodong\",\"key2\":1998,\"key3\":22.33,\"key4\":true}";
//解析成json对象
cJSON * json_obj = cJSON_Parse(json_str); //项存储
cJSON *item=NULL; //输出原字符串
printf("原字符串:%s\r\n",json_str); //获取string类型
item=cJSON_GetObjectItem(json_obj,"key1");
printf("\r\nkey1:%s\r\n",item->valuestring);
cJSON_Delete(item);//释放资源 //获取数字
item=cJSON_GetObjectItem(json_obj,"key2");
printf("\r\nkey2:%d\r\n",item->valueint);
cJSON_Delete(item);//释放资源 //获取数字
item=cJSON_GetObjectItem(json_obj,"key3");
printf("\r\nkey3:%f\r\n",item->valuedouble);
cJSON_Delete(item);//释放资源 //获取bool
item=cJSON_GetObjectItem(json_obj,"key4");
printf("\r\nkey4:%d\r\n",item->valueint);
cJSON_Delete(item);//释放资源 //是否资源
cJSON_Delete(json_obj);
}

解析多层级的json

代码

 #include <stdio.h>
#include "cJSON.h"
#include "cJSON.c"
void main(){
//待解析字符串
char *json_str="{\"key1\":\"dongxiaodong\",\"key2\":1998,\"myson\":{\"sonkey1\":\"东小东\",\"sonkey2\":2020}}";
//解析成json对象
cJSON * json_obj = cJSON_Parse(json_str); //项存储
cJSON *item=NULL;
//内部项存储
cJSON * item_item=NULL; //输出原字符串
printf("原字符串:%s\r\n",json_str); //获取string类型
item=cJSON_GetObjectItem(json_obj,"key1");
printf("\r\nkey1:%s\r\n",item->valuestring);
cJSON_Delete(item);//释放资源 //获取数字
item=cJSON_GetObjectItem(json_obj,"key2");
printf("\r\nkey2:%d\r\n",item->valueint);
cJSON_Delete(item);//释放资源 //子串
item=cJSON_GetObjectItem(json_obj,"myson");
item_item=cJSON_GetObjectItem(item,"sonkey1");
printf("\r\nmyson(sonkey1):%s\r\n",item_item->valuestring);
cJSON_Delete(item_item);//释放资源 item_item=cJSON_GetObjectItem(item,"sonkey2");
printf("\r\nmyson(sonkey2):%d\r\n",item_item->valueint);
cJSON_Delete(item_item);//释放资源 cJSON_Delete(item);//释放资源 //释放资源
cJSON_Delete(json_obj);
}

 解析多层json(数组形式)

代码

 #include <stdio.h>
#include "cJSON.h"
#include "cJSON.c"
void main(){
//待解析字符串
char *json_str="{\"key1\":\"dongxiaodong\",\"key2\":1998,\"myson\":[true,113]}";
//解析成json对象
cJSON * json_obj = cJSON_Parse(json_str); //项存储
cJSON *item=NULL;
//内部项存储
cJSON * item_item=NULL; //输出原字符串
printf("原字符串:%s\r\n",json_str); //获取string类型
item=cJSON_GetObjectItem(json_obj,"key1");
printf("\r\nkey1:%s\r\n",item->valuestring);
cJSON_Delete(item);//释放资源 //获取数字
item=cJSON_GetObjectItem(json_obj,"key2");
printf("\r\nkey2:%d\r\n",item->valueint);
cJSON_Delete(item);//释放资源 //获取子串
item=cJSON_GetObjectItem(json_obj,"myson"); //输出数组大小
printf("\r\n数组大小:%d\r\n",cJSON_GetArraySize(item)); //输出项1内容
item_item=cJSON_GetArrayItem(item,);
printf("\r\nmyson(0):%d\r\n",item_item->valueint);
//cJSON_Delete(item_item);//释放资源 //输出项2内容
item_item=cJSON_GetArrayItem(item,);
printf("\r\nmyson(1):%d\r\n",item_item->valueint);
cJSON_Delete(item_item);//释放资源 cJSON_Delete(item);//释放资源 //释放资源
cJSON_Delete(json_obj);
}

  解析混合json

代码

 #include <stdio.h>
#include "cJSON.h"
#include "cJSON.c"
void main(){
//待解析字符串
char *json_str="{\"key1\":\"dongxiaodong\",\"key2\":1998,\"myson\":[true,22,{\"son1\":\"dongxiaodong\",\"son2\":1998}]}";
//解析成json对象
cJSON * json_obj = cJSON_Parse(json_str); //项存储
cJSON *item=NULL;
//内部项存储
cJSON * item_item=NULL; //输出原字符串
printf("原字符串:%s\r\n",json_str); //获取string类型
item=cJSON_GetObjectItem(json_obj,"key1");
printf("\r\nkey1:%s\r\n",item->valuestring);
cJSON_Delete(item);//释放资源 //获取数字
item=cJSON_GetObjectItem(json_obj,"key2");
printf("\r\nkey2:%d\r\n",item->valueint);
cJSON_Delete(item);//释放资源 //获取子串
item=cJSON_GetObjectItem(json_obj,"myson"); //输出数组大小
printf("\r\n数组大小:%d\r\n",cJSON_GetArraySize(item)); //输出项1内容
item_item=cJSON_GetArrayItem(item,);
printf("\r\nmyson(0):%d\r\n",item_item->valueint);
//cJSON_Delete(item_item);//释放资源 //输出项2内容
item_item=cJSON_GetArrayItem(item,);
printf("\r\nmyson(1):%d\r\n",item_item->valueint);
cJSON_Delete(item_item);//释放资源 //项3内容
item_item=cJSON_GetArrayItem(item,);
cJSON *item_item_son=NULL; item_item_son =cJSON_GetObjectItem(item_item,"son1");
printf("\r\nmyson(2)(son1):%s\r\n",item_item_son->valuestring);
cJSON_Delete(item_item_son);//释放资源 item_item_son =cJSON_GetObjectItem(item_item,"son2");
printf("\r\nmyson(2)(son2):%d\r\n",item_item_son->valueint);
cJSON_Delete(item_item_son);//释放资源
cJSON_Delete(item_item);//释放资源 cJSON_Delete(item);//释放资源 //释放资源
cJSON_Delete(json_obj);
}

参考:

https://blog.csdn.net/shizhe0123/article/details/94742514

https://blog.csdn.net/fengxinlinux/article/details/53121287

https://www.cnblogs.com/skullboyer/p/8152157.html

不可不知的JSON处理库(cJSON)的更多相关文章

  1. c++ 使用json的库。cJSON

    cJSON官网是:http://sourceforge.net/projects/cjson/?source=recommended 最新版本是2013年的,与2009年的变化不是很大. 看了代码,觉 ...

  2. python 中的json解析库

    当一个json 数据很大的时候.load起来是很耗时的.python中常见的json解析库有cjson,simplesjson,json, 初步比较了一下, 对于loads来讲 simplejson ...

  3. Tomjson - 一个"短小精悍"的 json 解析库

    Tomjson,一个"短小精悍"的 json 解析库,tomjson使用Java语言编写,主要作用是把Java对象(JavaBean)序列化为json格式字符串,将json格式字符 ...

  4. fastjson是阿里巴巴的开源JSON解析库

    fastjson的API十分简洁. String text = JSON.toJSONString(obj); //序列化 VO vo = JSON.parseObject("{...}&q ...

  5. Tomjson - json 解析库

    Tomjson - 一个"短小精悍"的 json 解析库 Tomjson,一个"短小精悍"的 json 解析库,tomjson使用Java语言编写,主要作用是把 ...

  6. Delphi语言最好的JSON代码库 mORMot学习笔记1

    mORMot没有控件安装,直接添加到lib路径,工程中直接添加syncommons,syndb等到uses里 --------------------------------------------- ...

  7. C++的Json解析库:jsoncpp和boost

    C++的Json解析库:jsoncpp和boost - hzyong_c的专栏 - 博客频道 - CSDN.NET C++的Json解析库:jsoncpp和boost 分类: 网络编程 开源库 201 ...

  8. Java JSON处理库Jackson

    Jackson是一款为Java平台提供的一套数据处理类库工具,Jackson的主要功能是提供JSON解析和生成.另外,Jackson还提供额外的类库以支持处理Avro, CBOR, CSV, Smil ...

  9. Android JSON解析库Gson和Fast-json的使用对比和图书列表小案例

    Android JSON解析库Gson和Fast-json的使用对比和图书列表小案例 继上篇json解析,我用了原生的json解析,但是在有些情况下我们不得不承认,一些优秀的json解析框架确实十分的 ...

随机推荐

  1. spark机器学习从0到1逻辑斯蒂回归之(四)

      逻辑斯蒂回归 一.概念 逻辑斯蒂回归(logistic regression)是统计学习中的经典分类方法,属于对数线性模型.logistic回归的因变量可以是二分类的,也可以是多分类的.logis ...

  2. vue实现elment 可编辑树形控件

    功能实现程度: elment树形控件,已具备新增.删除功能,此项目,添加编辑功能,新增时可对节点命名,也可直接给已添加的节点修改名字 先看效果: 控件有所改动,如加输入框,输入关键字过滤,节点图标变换 ...

  3. 新概念英语三 新东方主讲Lesson1

    新概念二 Lesson95 词汇 ①get a shock 吓了一跳,得到一个惊喜 例:his wife got a shock get into a such mess 这么不幸搞得一片狼籍弄得这样 ...

  4. Windows10下打开MySQL服务 & 查看MySQL服务是否启动

    首先 确保电脑已安装MySQL客户端 其次 以管理员方式,打开Windows PowerShell 输入: net start mysql 回车 如下图: 可以了.

  5. SQL——SQL别名、UNION和SELECT INTO

    Alias(别名) - 为列名称和表名称指定别名    语法:表SELECT columnName(s) FROM tableName AS aliasName          列SELECT co ...

  6. java后端解决跨域

    1 package com.zys.boot_jeep.config; import org.springframework.context.annotation.Bean; import org.s ...

  7. python的生成器和迭代器

    三.推倒式从时间上比较:集合 字典 元祖 列表 (从小到大)占用内存比较:字典 集合 列表 元祖 (从大到小) 字典是可进行hash操作,操作的是字典的key ,而对list进行hash操作的时候操作 ...

  8. [CSS布局基础]居中布局的实现方式总结

    [原创]码路工人 Coder-Power 大家好,这里是码路工人有力量,我是码路工人,你们是力量. github-pages 博客园cnblogs 做Web开发少不了做页面布局.码路工人给大家总结一下 ...

  9. 12.Java连接Redis_Jedis_常用API

    上一篇总结我们使用我们本地的Eclipse中创建的jedis工程,链接到了我们处于VMware虚拟机上的Linux系统上的Redis服务,我们接下来讲一下jedis的一些常用的API. (1)jedi ...

  10. Android调试非常有用的命令集1_adb&aapt&git&repo&scp&while

    Linux部分场景非常有用的命令集_1_持续更新 这里面也包含了对于开发调试有用的命令,也可以看看. 这里不做详细说明或截图,仅作为记录和简单说明.注:可能只针对某一命令部分功能,不包含整个功能,若要 ...