1. 构造函数#

• JSON::Value()
  创建空的 JSON 值（null）。
• JSON::Value(Type type)
  创建指定类型的空值（如null、array、object等）。
• JSON::Value(bool value) / JSON::Value(int value) / JSON::Value(double value) / JSON::Value(const char* value)
  创建对应类型的 JSON 值。

2. 类型检查#

• bool isNull() const
  判断是否为null。
• bool isBool() const / isInt() / isDouble() / isString() / isArray() / isObject()
  判断值的类型。
• ValueType type() const
  返回值的类型（枚举值）。

3. 值的获取#

• bool asBool() const / int asInt() / double asDouble() / std::string asString()
  将值转换为指定类型（若类型不匹配会抛出异常）。
• const char* asCString() const
  将字符串值转换为 C 风格字符串。
• int size() const
  对于数组或对象，返回元素个数。

4. 数组操作#

• JSON::Value& append(const JSON::Value& value)
  向数组末尾添加元素。
• JSON::Value& operator[](ArrayIndex index)
  通过索引访问数组元素（索引越界时自动扩展数组）。

5. 对象操作#

• JSON::Value& operator[](const char* key) / operator[](const std::string& key)
  通过键访问或插入对象成员。
• bool isMember(const char* key) const / isMember(const std::string& key)
  判断对象是否包含指定键。
• const JSON::Value& get(const char* key, const JSON::Value& defaultValue) const
  获取键对应的值，若键不存在则返回默认值。
• std::vector<std::string> getMemberNames() const
  返回对象所有键的列表。
• void removeMember(const char* key) / removeMember(const std::string& key)
  删除对象中的键值对。

6. 其他操作#

• bool empty() const
  判断值是否为空（数组/对象为空，或值为null）。
• void clear()
  清空值（重置为null）。
• std::string toStyledString() const
  生成格式化的 JSON 字符串（用于调试）。
• bool operator==(const JSON::Value& other) const / operator!=(const JSON::Value& other)
  值的比较操作符。

示例代码#

1
#include <json/json.h>
2
#include <iostream>
3

4
int main() {
5
    // 创建 JSON 对象
6
    JSON::Value root;
7
    root["name"] = "John";
8
    root["age"] = 30;
9
    root["isStudent"] = false;
10

11
    // 创建 JSON 数组
12
    JSON::Value hobbies;
13
    hobbies.append("reading");
14
    hobbies.append("coding");
15
    root["hobbies"] = hobbies;
16

17
    // 访问值
18
    std::cout << "Name: " << root["name"].asString() << std::endl;
19
    std::cout << "Age: " << root["age"].asInt() << std::endl;
20

21
    // 检查成员
22
    if (root.isMember("isStudent")) {
23
        std::cout << "Is student: " << (root["isStudent"].asBool() ? "Yes" : "No") << std::endl;
24
    }
25

26
    // 遍历数组
27
    for (int i = 0; i < root["hobbies"].size(); ++i) {
28
        std::cout << "Hobby " << i << ": " << root["hobbies"][i].asString() << std::endl;
29
    }
30

31
    // 生成格式化字符串
32
    std::cout << root.toStyledString() << std::endl;
33

34
    return 0;
35
}

注意事项

1. 类型安全：使用as*()方法时需确保类型匹配，否则可能抛出异常。
2. 空值处理：访问不存在的键或越界索引会返回null值，需先检查isNull()。
3. 性能提示：频繁调用getMemberNames()可能影响性能，建议缓存结果。

Json::Reader#

markdown 以下是 JsonCpp 中 JSON::Reader 类 的常用函数及功能介绍：

1
JSON::Features features;
2
features.allowComments_ = true;        // 允许注释（// 或 /* */）
3
features.strictRoot_ = false;          // 根节点可以是任意类型（非严格对象/数组）
4
features.allowDroppedNullPlaceholders_ = true;  // 允许数组中缺失值（如 [1,,3]）
5
features.allowNumericKeys_ = true;     // 允许数字作为对象键名
6
JSON::Reader reader(features);

1
#include <json/json.h>
2
#include <fstream>
3
#include <iostream>
4

5
int main() {
6
    // 从字符串解析
7
    std::string jsonStr = R"({
8
        "name": "Alice",
9
        "age": 25,
10
        "hobbies": ["reading", "swimming"]
11
    })";
12

13
    JSON::Value root;
14
    JSON::Reader reader;
15
    bool parsingSuccessful = reader.parse(jsonStr, root);
16

17
    if (parsingSuccessful) {
18
        std::cout << "Name: " << root["name"].asString() << std::endl;
19
        std::cout << "Age: " << root["age"].asInt() << std::endl;
20
    } else {
21
        std::cerr << "Failed to parse JSON: " << reader.getFormattedErrorMessages() << std::endl;
22
    }
23

24
    // 从文件解析
25
    std::ifstream file("data.json");
26
    if (file.is_open()) {
27
        JSON::Value fileRoot;
28
        bool fileParsingSuccessful = reader.parse(file, fileRoot);
29
        if (fileParsingSuccessful) {
30
            // 处理文件中的 JSON 数据
31
        } else {
32
            std::cerr << "Failed to parse file: " << reader.getFormattedErrorMessages() << std::endl;
33
        }
34
        file.close();
35
    }
36

37
    return 0;
38
}