CJSON库

目录

一、介绍

1、JSON是什么

2、为什么使用CJSON

3、JSON格式

二、使用CJSON构造JSON

1、创建对象

2、添加字段

3、转换格式

4、释放对象

三、使用CJSON解析JSON

1、解析数据

[2、 获取字段](#2、 获取字段)

3、释放对象


一、介绍

1、JSON是什么

JSON是什么呢?JSON全称JavaScript Object Notation,是一种轻量级的数据交换格式,主要用于存储和交换文本信息。换句话说就是我们用JSON就是为了解析收到的数据和发送对方能够解析的数据。

简洁和清晰的层次结构使得JSON成为理想的数据交换语言,易于人阅读和编写,同时也易于机器解析和生成,并有效地提升网络传输速率。

2、为什么使用CJSON

CJSON是一个轻量级、高效、易用的JSON解析库,适用于C语言。 在做项目开发时,为什么大家都喜欢选择CJSON来解析JSON字符串呢?CJSON工程文件很简单,仅一个.c文件和一个.h文件,文件体积很小。除此之外,cJSON 库通过简单的 API 提供了高效的 JSON 处理功能。它允许用户解析 JSON 字符串、创建和修改 JSON 对象、提取字段值,以及将 JSON 对象序列化为字符串。所以cJSON 库非常适合在资源受限的嵌入式系统中使用。

3、JSON格式

对象在花括号 {} 中表示,一组键值对组成。键是字符串,值可以是字符串、数字、布尔值、数组、对象或 null。大家可以对照这个示例:

{
    "name": "xiao xin",
    "age": 21,
    "is_student": true,
    "email": "xxxxxxxxxx@qq.com",
    "skills": [ "Python", "C"],
    "address": {
        "street": "123 Main St",
        "city": "Anytown",
        "state": "CA",
        "postal_code": "12345"
    }
}

二、使用CJSON构造JSON

在 C 语言中使用 cJSON 库来构造 JSON 数据非常简单。接下来我为大家整理了构造JSON常用的几个函数。

1、创建对象

我们需要先创建一个空的 cJSON 对象,表示一个 JSON 对象 {}

cJSON *cJSON_CreateObject(void);

2、添加字段

当创建完对象后,我们需要调用函数往该对象中添加相对应的字段。以下是我整理的常用函数。

(1)添加布尔值

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

(2)添加空值

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

(3)添加JSON数组字段

void cJSON_AddItemToObject(cJSON *object, const char *name, cJSON *item);

(4)添加JSON对象字段

void cJSON_AddItemToObject(cJSON *object, const char *name, cJSON *item);

3、转换格式

最后,我们需要将 cJSON 对象转换为 JSON 格式的字符串。

char *cJSON_Print(const cJSON *item);

该函数会将 cJSON 对象转换为 JSON 格式的字符串并返回这个字符串的指针。这个函数非常有用,可以帮助将 cJSON 对象构建的 JSON 数据序列化为可读的文本格式,便于输出、存储或传输。

4、释放对象

在使用 cJSON 解析 JSON 数据或构造 JSON 对象之后,我们需要释放内存,以防止内存泄漏。

void cJSON_Delete(cJSON *c);

c:指向要删除的 cJSON 对象的指针。

给大家一个参考代码,大家可以自己动手试试看(编译时注意链接CJSON动态库):

#include <stdio.h>
#include <stdlib.h>
#include <cJSON.h>

int main()
{
    // 创建一个 cJSON 对象,表示一个 JSON 对象 {}
	cJSON *root = cJSON_CreateObject();
    
    // 添加字符串字段
	cJSON_AddStringToObject(root, "name", "xiao xin");

    // 添加整数字段
	cJSON_AddNumberToObject(root, "age", 21);

    // 创建一个包含技能的 JSON 数组 "skills"
	cJSON *skillsArray = cJSON_CreateArray();
	cJSON_AddItemToArray(skillsArray, cJSON_CreateString("Python"));
	cJSON_AddItemToArray(skillsArray, cJSON_CreateString("C"));
	cJSON_AddItemToObject(root, "skills", skillsArray);

    // 添加布尔值字段
	cJSON_AddBoolToObject(root, "is_student", cJSON_True);

    // 添加空值字段
	cJSON_AddNullToObject(root, "notes");

    // 添加联系信息 JSON 对象字段
	cJSON *contactObject = cJSON_CreateObject();
	cJSON_AddStringToObject(contactObject, "email", "xxxxxxxxxx@qq.com");
	cJSON_AddStringToObject(contactObject, "phone", "555-555-5555");
	cJSON_AddItemToObject(root, "contact", contactObject);

    // 将 cJSON 对象转换为 JSON 格式的字符串
	char *json_string = cJSON_Print(root);

	printf("%s\n", json_string);    // 打印生成的 JSON 字符串

	cJSON_Delete(root);            // 释放 cJSON 对象占用的内存

	free(json_string);            // 释放 cJSON_Print 分配的内存

	return 0;
}

运行结果:

三、使用CJSON解析JSON

在 C 语言中使用 cJSON 库来解析 JSON 数据非常简单。接下来我为大家整理了构造JSON常用的几个函数。

1、解析数据

我们需要先将JSON格式的字符串解析成CJSON对象。

cJSON *cJSON_Parse(const char *value);

该函数是解析 JSON 数据的关键函数,将一个JSON数据包,按照cJSON结构体的结构序列化整个数据包,并在堆中开辟一块内存存储cJSON结构体,成功后返回一个指向解析后的 cJSON 对象的指针。

2、 获取字段

接下来我们从一个 cJSON 对象中获取指定键的值。

cJSON *cJSON_GetObjectItem(cJSON *object, const char *string);

该函数用于获取JSON字符串字段值,成功返回一个指向cJSON类型的结构体指针。

3、释放对象

和2、4是一样的,这里就不再重复赘述了。

给大家一个参考代码,大家可以自己动手试试看(编译时注意链接CJSON动态库):

#include <stdio.h>
#include <stdlib.h>
#include "cJSON.h"

int main() {
    // JSON 字符串
    const char *json_string = "{"
        "\"name\":\"xiao xin\","
        "\"age\":21,"
        "\"is_student\":true,"
        "\"email\":\"xxxxx@qq.com\","
        "\"skills\":[\"Python\",\"C\"],"
        "\"address\":{"
            "\"street\":\"123 Main St\","
            "\"city\":\"Anytown\","
            "\"state\":\"CA\","
            "\"postal_code\":\"12345\""
        "}"
    "}";

    // 解析 JSON 字符串
    cJSON *root = cJSON_Parse(json_string);
    if (root == NULL) {
        const char *error_ptr = cJSON_GetErrorPtr();
        if (error_ptr != NULL) {
            fprintf(stderr, "Error before: %s\n", error_ptr);
        }
        return 1;
    }

    // 提取字段
    cJSON *name = cJSON_GetObjectItem(root, "name");
    cJSON *age = cJSON_GetObjectItem(root, "age");
    cJSON *is_student = cJSON_GetObjectItem(root, "is_student");
    cJSON *email = cJSON_GetObjectItem(root, "email");
    cJSON *skills = cJSON_GetObjectItem(root, "skills");
    cJSON *address = cJSON_GetObjectItem(root, "address");

    // 打印字段
    if (cJSON_IsString(name) && (name->valuestring != NULL)) {
        printf("Name: %s\n", name->valuestring);
    }

    if (cJSON_IsNumber(age)) {
        printf("Age: %d\n", age->valueint);
    }

    if (cJSON_IsBool(is_student)) {
        printf("Is student: %s\n", cJSON_IsTrue(is_student) ? "true" : "false");
    }

    if (cJSON_IsString(email) && (email->valuestring != NULL)) {
        printf("Email: %s\n", email->valuestring);
    }

    if (cJSON_IsArray(skills)) {
        printf("Skills:\n");
        cJSON *skill = NULL;
        cJSON_ArrayForEach(skill, skills) {
            if (cJSON_IsString(skill)) {
                printf("  - %s\n", skill->valuestring);
            }
        }
    }

    if (cJSON_IsObject(address)) {
        cJSON *street = cJSON_GetObjectItem(address, "street");
        cJSON *city = cJSON_GetObjectItem(address, "city");
        cJSON *state = cJSON_GetObjectItem(address, "state");
        cJSON *postal_code = cJSON_GetObjectItem(address, "postal_code");

        if (cJSON_IsString(street) && (street->valuestring != NULL)) {
            printf("Street: %s\n", street->valuestring);
        }

        if (cJSON_IsString(city) && (city->valuestring != NULL)) {
            printf("City: %s\n", city->valuestring);
        }

        if (cJSON_IsString(state) && (state->valuestring != NULL)) {
            printf("State: %s\n", state->valuestring);
        }

        if (cJSON_IsString(postal_code) && (postal_code->valuestring != NULL)) {
            printf("Postal Code: %s\n", postal_code->valuestring);
        }
    }

    // 释放 cJSON 对象占用的内存
    cJSON_Delete(root);

    return 0;
}

运行结果:

相关推荐
励志成为嵌入式工程师3 小时前
c语言简单编程练习9
c语言·开发语言·算法·vim
Peter_chq4 小时前
【操作系统】基于环形队列的生产消费模型
linux·c语言·开发语言·c++·后端
hikktn5 小时前
如何在 Rust 中实现内存安全:与 C/C++ 的对比分析
c语言·安全·rust
观音山保我别报错6 小时前
C语言扫雷小游戏
c语言·开发语言·算法
小林熬夜学编程8 小时前
【Linux系统编程】第四十一弹---线程深度解析:从地址空间到多线程实践
linux·c语言·开发语言·c++·算法
墨墨祺8 小时前
嵌入式之C语言(基础篇)
c语言·开发语言
躺不平的理查德8 小时前
数据结构-链表【chapter1】【c语言版】
c语言·开发语言·数据结构·链表·visual studio
幼儿园园霸柒柒10 小时前
第七章: 7.3求一个3*3的整型矩阵对角线元素之和
c语言·c++·算法·矩阵·c#·1024程序员节
好想有猫猫10 小时前
【51单片机】串口通信原理 + 使用
c语言·单片机·嵌入式硬件·51单片机·1024程序员节
摆烂小白敲代码11 小时前
背包九讲——背包问题求方案数
c语言·c++·算法·背包问题·背包问题求方案数