在C++中解析JSON：从基础到高级技巧

于 2025-02-25 10:07:33 发布
阅读量870 收藏 7
点赞数 18
文章标签： c++ json 开发语言
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/Myqijiahai/article/details/145845411
版权

在C++中解析JSON：从基础到高级技巧

在现代C++开发中，JSON（JavaScript Object Notation）作为一种轻量级的数据交换格式，被广泛应用于网络通信、配置文件处理以及数据存储。解析JSON数据是许多C++应用的核心需求之一。与其他语言相比，C++在处理JSON时需要更多的手动操作，但也有许多强大的库可供选择。本文将详细介绍如何在C++中解析JSON，包括基础用法、高级技巧以及性能优化。

一、为什么需要解析JSON？

JSON是一种易于阅读和编写的文本格式，非常适合用于数据交换。在C++开发中，解析JSON的需求无处不在：

  1. 处理API响应：许多Web API返回的数据都是JSON格式，解析这些数据是与外部服务交互的基础。
  2. 配置文件：JSON格式的配置文件易于维护，解析这些文件可以帮助我们动态配置应用。
  3. 前后端交互：在前后端分离的架构中，JSON是前端和后端数据交互的桥梁。

因此，掌握JSON解析是每个C++开发者必备的技能。

二、选择合适的JSON库

C++中有许多优秀的JSON库可供选择，其中最流行的是nlohmann/json和RapidJSON。这两个库都提供了强大的功能和良好的性能。

1. nlohmann/json

nlohmann/json是一个基于单头文件的JSON库，使用现代C++特性（如C++11及以上版本），提供了简洁易用的API。

安装

nlohmann/json可以通过单头文件集成到项目中，也可以通过包管理工具（如vcpkg或Conan）安装。

# 使用vcpkg安装
vcpkg install nlohmann-json
基础用法
#include <nlohmann/json.hpp>
#include <iostream>

using json = nlohmann::json;

int main() {
    // JSON字符串
    std::string jsonString = R"({
        "name": "John Doe",
        "age": 30,
        "email": "john.doe@example.com"
    })";

    // 解析JSON字符串
    auto j = json::parse(jsonString);

    // 访问JSON数据
    std::cout << "Name: " << j["name"] << std::endl;
    std::cout << "Age: " << j["age"] << std::endl;
    std::cout << "Email: " << j["email"] << std::endl;

    return 0;
}

2. RapidJSON

RapidJSON是一个高性能的JSON库，支持C++98及以上版本。它提供了丰富的功能，包括解析、生成和操作JSON数据。

安装

RapidJSON可以通过单头文件集成到项目中，也可以通过包管理工具安装。

# 使用vcpkg安装
vcpkg install rapidjson
基础用法
#include "rapidjson/document.h"
#include <iostream>

int main() {
    // JSON字符串
    const char* jsonString = R"({
        "name": "John Doe",
        "age": 30,
        "email": "john.doe@example.com"
    })";

    // 解析JSON字符串
    rapidjson::Document document;
    document.Parse(jsonString);

    // 访问JSON数据
    if (document.HasMember("name")) {
        std::cout << "Name: " << document["name"].GetString() << std::endl;
    }
    if (document.HasMember("age")) {
        std::cout << "Age: " << document["age"].GetInt() << std::endl;
    }
    if (document.HasMember("email")) {
        std::cout << "Email: " << document["email"].GetString() << std::endl;
    }

    return 0;
}

三、高级技巧：处理复杂JSON数据

在实际开发中，JSON数据往往更加复杂，可能包含嵌套对象、数组或动态字段。以下是一些处理复杂JSON数据的高级技巧。

1. 解析嵌套JSON

假设我们有以下嵌套的JSON数据：

{
    "users": [
        { "name": "John Doe", "age": 30, "email": "john.doe@example.com" },
        { "name": "Jane Doe", "age": 25, "email": "jane.doe@example.com" }
    ]
}
使用nlohmann/json解析嵌套JSON
#include <nlohmann/json.hpp>
#include <iostream>

using json = nlohmann::json;

int main() {
    std::string jsonString = R"({
        "users": [
            { "name": "John Doe", "age": 30, "email": "john.doe@example.com" },
            { "name": "Jane Doe", "age": 25, "email": "jane.doe@example.com" }
        ]
    })";

    auto j = json::parse(jsonString);

    for (const auto& user : j["users"]) {
        std::cout << "Name: " << user["name"] << std::endl;
        std::cout << "Age: " << user["age"] << std::endl;
        std::cout << "Email: " << user["email"] << std::endl;
    }

    return 0;
}
使用RapidJSON解析嵌套JSON
#include "rapidjson/document.h"
#include <iostream>

int main() {
    const char* jsonString = R"({
        "users": [
            { "name": "John Doe", "age": 30, "email": "john.doe@example.com" },
            { "name": "Jane Doe", "age": 25, "email": "jane.doe@example.com" }
        ]
    })";

    rapidjson::Document document;
    document.Parse(jsonString);

    if (document.HasMember("users") && document["users"].IsArray()) {
        for (const auto& user : document["users"].GetArray()) {
            std::cout << "Name: " << user["name"].GetString() << std::endl;
            std::cout << "Age: " << user["age"].GetInt() << std::endl;
            std::cout << "Email: " << user["email"].GetString() << std::endl;
        }
    }

    return 0;
}

2. 动态字段处理

在某些情况下，JSON结构可能不固定，字段名称可能动态变化。可以通过遍历JSON对象的键来处理动态字段。

使用nlohmann/json处理动态字段
#include <nlohmann/json.hpp>
#include <iostream>

using json = nlohmann::json;

int main() {
    std::string jsonString = R"({
        "user1": { "name": "John Doe", "age": 30 },
        "user2": { "name": "Jane Doe", "age": 25 }
    })";

    auto j = json::parse(jsonString);

    for (const auto& [key, value] : j.items()) {
        std::cout << "User: " << key << std::endl;
        std::cout << "  Name: " << value["name"] << std::endl;
        std::cout << "  Age: " << value["age"] << std::endl;
    }

    return 0;
}
使用RapidJSON处理动态字段
#include "rapidjson/document.h"
#include <iostream>

int main() {
    const char* jsonString = R"({
        "user1": { "name": "John Doe", "age": 30 },
        "user2": { "name": "Jane Doe", "age": 25 }
    })";

    rapidjson::Document document;
    document.Parse(jsonString);

    for (auto& member : document.GetObject()) {
        std::cout << "User: " << member.name.GetString() << std::endl;
        std::cout << "  Name: " << member.value["name"].GetString() << std::endl;
        std::cout << "  Age: " << member.value["age"].GetInt() << std::endl;
    }

    return 0;
}

四、性能优化技巧

在处理大规模JSON数据时，性能优化变得尤为重要。以下是一些优化建议：

1. 使用流式解析

对于大型JSON文件，可以使用流式解析来避免将整个文件加载到内存中。RapidJSON提供了流式解析器（Reader），可以逐字符解析JSON数据。

示例：使用RapidJSON的流式解析
#include "rapidjson/reader.h"
#include <iostream>
#include <string>

class Handler {
public:
    bool Null() { return true; }
    bool Bool(bool b) { std::cout << (b ? "true" : "false") << std::endl; return true; }
    bool Int(int i) { std::cout << i << std::endl; return true; }
    bool Uint(unsigned u) { std::cout << u << std::endl; return true; }
    bool Double(double d) { std::cout << d << std::endl; return true; }
    bool String(const char* str, SizeType length, bool copy) { std::cout << std::string(str, length) << std::endl; return true; }
    bool StartObject() { std::cout << "{" << std::endl; return true; }
    bool Key(const char* str, SizeType length, bool copy) { std::cout << "  " << std::string(str, length) << ": "; return true; }
    bool EndObject(SizeType memberCount) { std::cout << "}" << std::endl; return true; }
    bool StartArray() { std::cout << "[" << std::endl; return true; }
    bool EndArray(SizeType elementCount) { std::cout << "]" << std::endl; return true; }
};

int main() {
    const char* jsonString = R"({
        "name": "John Doe",
        "age": 30,
        "emails": ["john.doe@example.com", "doe.john@example.com"]
    })";

    rapidjson::Reader reader;
    Handler handler;
    reader.Parse(jsonString, handler);

    return 0;
}

2. 使用内存池

RapidJSON提供了内存池（MemoryPoolAllocator），可以减少内存分配的开销，提高解析性能。

示例：使用RapidJSON的内存池
#include "rapidjson/document.h"
#include "rapidjson/prettywriter.h"
#include "rapidjson/stringbuffer.h"
#include <iostream>

int main() {
    const char* jsonString = R"({
        "name": "John Doe",
        "age": 30,
        "emails": ["john.doe@example.com", "doe.john@example.com"]
    })";

    rapidjson::Document document;
    document.Parse(jsonString);

    rapidjson::Document::AllocatorType& allocator = document.GetAllocator();

    // 添加新字段
    document.AddMember("newField", "newValue", allocator);

    // 序列化为字符串
    rapidjson::StringBuffer buffer;
    rapidjson::PrettyWriter<rapidjson::StringBuffer> writer(buffer);
    document.Accept(writer);

    std::cout << buffer.GetString() << std::endl;

    return 0;
}

3. 错误处理

在解析JSON时，错误处理非常重要。RapidJSON提供了详细的错误信息，可以通过GetParseError()和GetErrorOffset()获取。

示例：处理解析错误
#include "rapidjson/document.h"
#include <iostream>

int main() {
    const char* jsonString = R"({
        "name": "John Doe",
        "age": 30,
        "emails": ["john.doe@example.com", "doe.john@example.com"
    })";

    rapidjson::Document document;
    if (document.Parse(jsonString).HasParseError()) {
        std::cerr << "Parse error at offset " << document.GetErrorOffset() << std::endl;
    } else {
        std::cout << "Name: " << document["name"].GetString() << std::endl;
    }

    return 0;
}

五、总结

在C++中解析JSON是一个常见的需求。通过选择合适的库（如nlohmann/json或RapidJSON），开发者可以轻松地解析和操作JSON数据。对于复杂的数据结构，可以通过嵌套解析、动态字段处理和流式解析等技术来优化性能。希望本文能帮助你在C++开发中更高效地处理JSON数据。

如果你在实际开发中遇到问题，建议查阅相关库的官方文档或社区资源。希望本文能帮助你更好地掌握C++中的JSON解析技巧！

JSON简介及C++中的JSON使用指南
yy_xzz的博客
03-26 1901
JSON（JavaScript Object Notation）是一种轻量级的数据交换格式，采用文本格式存储和传输数据。它易于人阅读和编写，同时也易于机器解析和生成。JSON广泛应用于Web API、配置文件、数据存储等领域。C++标准库没有内置JSON支持，但可以使用第三方库来解析和生成JSON。RapidJSON 是一个高效的C++ JSON解析库，适用于对性能要求较高的场景。
RapidJSON 处理 JSON（高性能 C++ 库）（四）
最新发布
风一流世的专栏
04-01 708
RapidJSON 是什么？ ​ RapidJSON 是一个高效、可移植的 C++ JSON 解析库，专为高性能应用设计。它具有以下特点： ​ 超快：比许多 JSON 库（如 cJSON、JSONCPP）解析速度更快，适用于高性能应用。 ​ 全功能：支持DOM（文档对象模型）解析和SAX（流式解析），适用于不同场景。 ​ 零依赖：仅使用 C++ 标准库，无需额外的库支持。
C++实现精简实用的json解析库
FlameCyclone的博客
10-22 555
自己实现的极简的json解析库
C++解析JSON数据
11-17
VC++要使用JSON来解析数据，这个源码工程进行编译链接就可以得到一个静态链接库json.lib，只需要将这个lib文件拷贝到你的工程目录下，并将\include\json复制到工程目录下，然后将这些头文件加到工程中去就可以了。 #pragma comment(lib, "json_mtd.lib") #include "json/json.h"
JSON解析（C++）
tiny_lxf的博客
09-27 2812
本文主要介绍使用 jsoncpp 库，编写C++语言的 JSON 解析程序。 1 概述 jsoncpp 是一个可以与 JSON 进行交互的C++库。官网定义如下： jsoncpp is an implementation of a JSON reader and writer in C++. 通过使用 jsoncpp ，我们可以对 JSON 进行读写。 2 示例代码 2.1 从字符串中...
C++解析json文件
超爱吃小蛋糕的66的博客
01-08 1万+
文章目录1 JSON文件简介[1]1.1 JSON文件的语法规则1.2 JSON值的类型2 JSON文件解析 1 JSON文件简介[1] 一个项目在设计时会存在很多参数，比如data文件路径、外设名称与相关参数、文件储存路径等等，这些参数根据实际需要可能需要修改的频率比较频繁，如果放在程序里面不仅查找比较麻烦，而且每次修改完就得重新编译一次，超级麻烦。所以可以将这种类型的参数文件都放在一个文本里面，然后设计一个函数接口来读取这些参数并存储在结构体或者其它类型的容器中。 之前为了方便将参数写进了TXT中，ke
C++ 解析Json——jsoncpp
typ2004的专栏
04-14 1048
C++ 解析Json——jsoncpp JSON(JavaScript Object Notation) 是一种轻量级的数据交换格式，和xml类似，本文主要对VS2008中使用Jsoncpp解析json的方法做一下记录。 Jsoncpp是个跨平台的开源库，下载地址：http://sourceforge.net/projects/jsoncpp/，我下载的是v0.5.0，压缩包大约104K。
C++解析JSON文件
StarWang的博客
08-14 1万+
在学习解析JSON文件之前，我们应该先了解什么是JSON。JSON(JavaScript Object Notation, JS 对象简谱) 是一种轻量级的数据交换格式。它基于 ECMAScript (欧洲计算机协会制定的js规范)的一个子集，采用完全独立于编程语言的文本格式来存储和表示数据。简洁和清晰的层次结构使得 JSON 成为理想的数据交换语言。易于人阅读和编写，同时也易于机器解析和生成，并有效地提升网络传输效率。...
JSON 4 C++
patdz的专栏
07-30 849
转自： http://hi.baidu.com/awz_tiger/item/e877551d9ac0e1f665eabfd9 最初出处不可考，在此衷心感谢文章作者。 使用C++处理JSON数据交换格式 一、摘要     JSON的全称为：JavaScript Object Notation，顾名思义，JSON是用于标记Javascript对象的，JSON官方的解释为：JS
C++ 解析Json
09-05
c++ 解析Json
C、C++中对json格式数据的解析和封装
浮若于心
08-31 8071
【代码】C语言中对json格式数据的解析和封装。
c++解析json格式框架
04-24
基于c++的json格式解析，框架为CJson
c/c++ 解析JSON数据
05-05
用C语言解析和组装JSON数据（string或从文件读取）： ，并且能取某个item值 。 我在vs2010上运行成功，附件为整个工程 。 （注：如果工程有编译上的error之类的，像fopen、fprintf： 可以修改： 选项Project | Configuration Properties | C/C++ | Preprocessor | Preprocessor Definitions 添加_CRT_SECURE_NO_DEPRECATE和_SCL_SECURE_NO_DEPRECATE ）
C++解析json数据
热门推荐
qq_38616559的博客
08-23 1万+
Json::Value fcgiRetData; ...//获取到fcgiRetData数据 Json::StyledWriter styledWriter; string response = styledWriter.write(fcgiRetData);//将fcgiRetData的json数据格式化 转载：C++解析JSON格式数据 1：封装JSON数据为string std::string DataToJson() { Json::FastWriter writerinfo; J
C++解析Json
horizons_kong的博客
12-27 2790
一、简单介绍 JSON 的全称为：JavaScript Object Notation。 JSON 是用于标记 Javascript 对象的。 JSON 官方的解释为：JSON 是一种轻量级的数据传输格式，我们将它理解为一种数据类型就好。 其格式一般如下（下面程序会有例子）： {      “Name“:“Json”,      "Year":"199
C++ JSON解析
cliu1_16的博客
02-06 1010
【代码】C++ JSON解析。
c++解析json
weixin_30616969的博客
11-30 279
一、简单介绍 JSON的全称为：JavaScript Object Notation，JSON是用于标记Javascript对象的，JSON官方的解释为：JSON是一种轻量级的数据传输格式。 二、第三方库 jsoncpp：它是比较出名的C++ JSON解析库。地址：http://sourceforge.net/projects/jsoncpp ...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值