jsoncpp 最新版本为 master 分支，必须用新版本的支持 C++ 11 的编译器，C++ Builder 需要选择 clang 编译器，不可以使用 Borland 编译器。
下载和编译 jsoncpp 可以参考《C++ Builder 编译 jsoncpp 库 (master 分支)》

• 使用 jsoncpp 静态库
• 解析 json 字符串
• 解析 json 文件
• 可能抛出的异常
• 判断 Json::Value 的类型
• 下载本文例子

一. 使用 jsoncpp 静态库

1. 下载和编译 jsoncpp 静态库

下载和编译 jsoncpp 可以参考《C++ Builder 编译 jsoncpp 库 (master 分支)》

2. 在项目选项里面，添加头文件和库文件的路径

选择菜单 Project -> Options

添加头文件和库文件的路径

头文件的路径需要添加这个文件夹：

头文件的文件夹

库文件的路径需要添加这个文件夹：

库文件的文件夹

选择 clang 编译器，把 Borland 编译器的对钩去掉：

选择 clang 编译器，把 Borland 编译器的对钩去掉

3. 包含头文件和链接库文件

#include "json/json.h"

#if defined(__clang__) && (__POINTER_WIDTH__ == 64)
  #pragma link "jsoncpp.a"
#else
  #pragma link "jsoncpp.lib"
#endif

包含头文件，链接库文件

二. 解析 json 字符串

使用 Json::CharReaderBuilder 和 Json::CharReader 解析 json 字符串，解析之后放在 Json::Value 里面。

Json::Value 里面存储的可能是一个单个的值，比如整数、浮点数、字符串等，也可能是一组键值对，也可能是数组。

Json::Value v;

如果 v 是 "key" : value 形式的键值对，
Json::Value &value = v["key"]; // 关键字 key 的值

如果 v 是数组
Json::Value &value = v[i]; // 数组第 i 个元素的值

如果要把 Json::Value 储存的单个值读出来，需要用 Json::Value 的成员函数：

例：从 Memo 控件里面获取 json 字符串，假定内容如下：

{
    "name" : "JSON 测试程序 - 玄坴",
    "desc" : "Test JSON, Copyright © Hsuanlu",
    "value": 1234.56,
    "故障" :
    [
        { "编码":101, "描述":"故障1" },
        { "编码":102, "描述":"故障2" }
    ]
}

程序代码：

虽然 C++ 11 规定了 u8"这是 UTF-8 字符串" 这样的写法，但是目前的 C++ Builder 编译器还不支持，所以定义了一个 _u8s 在程序里面使用能够简单方便一些：
#define _u8s(s) UTF8String(s).c_str()

#define _u8s(s) UTF8String(s).c_str()
void __fastcall TForm1::Button1Click(TObject *Sender)
{
    try
    {
        UTF8String txt = Memo1->Text;

        Json::Value jsValue;
        Json::String jsErrors;
        Json::CharReaderBuilder jcrBuilder;
        std::unique_ptr<Json::CharReader>jcReader(jcrBuilder.newCharReader());

        if(!jcReader->parse(txt.c_str(), txt.c_str()+txt.Length(), &jsValue, &jsErrors))
        {
            Memo2->Lines->Add(L"JSON 解析错误");
            return;
        }

        UTF8String sVal;
        double lfVal;
        int iVal;

        sVal = jsValue["name"].asCString();
        Memo2->Lines->Add(sVal);

        sVal = jsValue["desc"].asCString();
        Memo2->Lines->Add(sVal);

        lfVal = jsValue["value"].asDouble();
        Memo2->Lines->Add(lfVal);

        for(int i=0; i<2; i++)
        {
            Json::Value &jsFault = jsValue[_u8s(L"故障")][i];
            iVal = jsFault[_u8s(L"编码")].asInt();
            Memo2->Lines->Add(iVal);

            sVal = jsFault[_u8s(L"描述")].asCString();
            Memo2->Lines->Add(sVal);
        }
    }
    catch(std::exception &e)
    {
        UTF8String sErrStr = e.what();
        Memo2->Lines->Add(L"错误：" + sErrStr);
    }
    catch(Exception &e)
    {
        UTF8String sErrStr = e.Message;
        Memo2->Lines->Add(L"错误：" + sErrStr);
    }
}

运行结果：

解析 json 的运行结果

三. 解析 json 文件

只要把文件内容读到 UTF8String 里面就可以用前面的解析 json 字符串的方法解析了。

下面程序把 L"d:\\folder\\filename.txt" 读到 UTF8String txt 里面，按照 BOM 自动识别文件编码 UTF-8 / UNICODE 等，如果没有 BOM 会认为是 ANSI 编码 (由操作系统确定具体编码，Windows 10 新版在控制面板里面可以设为没有 BOM 认为是 UTF-8，否则认为是 ANSI)。

    std::auto_ptr<TStringList>sl(new TStringList);
    sl->LoadFromFile(L"d:\\folder\\filename.txt");
    UTF8String txt = sl->Text;

如果要指定读取的文件是 UTF-8 编码，LoadFromFile 需要加参数 TEncoding::UTF8，如果读取的文件不是 UTF-8 编码，会抛出异常。

    sl->LoadFromFile(L"d:\\folder\\filename.txt", TEncoding::UTF8);

文件读取完成，就可以按照前面第二部分所述的解析 json 字符串的方法了。

完整的例子：仍然需要前面例子的宏 #define _u8s(s) UTF8String(s).c_str()

void __fastcall TForm1::Button2Click(TObject *Sender)
{
    try
    {
        std::auto_ptr<TStringList>sl(new TStringList);
        sl->LoadFromFile(L"d:\\folder\\filename.txt");
        UTF8String txt = sl->Text;

        Json::Value jsValue;
        Json::String jsErrors;
        Json::CharReaderBuilder jcrBuilder;
        std::unique_ptr<Json::CharReader>jcReader(jcrBuilder.newCharReader());

        if(!jcReader->parse(txt.c_str(), txt.c_str()+txt.Length(), &jsValue, &jsErrors))
        {
            Memo2->Lines->Add(L"JSON 解析错误");
            return;
        }

        UTF8String sVal;
        double lfVal;
        int iVal;

        sVal = jsValue["name"].asCString();
        Memo2->Lines->Add(sVal);

        sVal = jsValue["desc"].asCString();
        Memo2->Lines->Add(sVal);

        lfVal = jsValue["value"].asDouble();
        Memo2->Lines->Add(lfVal);

        for(int i=0; i<2; i++)
        {
            Json::Value &jsFault = jsValue[_u8s(L"故障")][i];
            iVal = jsFault[_u8s(L"编码")].asInt();
            Memo2->Lines->Add(iVal);

            sVal = jsFault[_u8s(L"描述")].asCString();
            Memo2->Lines->Add(sVal);
        }
    }
    catch(std::exception &e)
    {
        UTF8String sErrStr = e.what();
        Memo2->Lines->Add(L"错误：" + sErrStr);
    }
    catch(Exception &e)
    {
        UTF8String sErrStr = e.Message;
        Memo2->Lines->Add(L"错误：" + sErrStr);
    }
}

四. 可能抛出的异常

必须要注意 jsoncpp 会抛出 std::exception 类型的异常，而 C++ Builder 会抛出 Exception 类型的异常 (注意大小写，这个的开头字母是大写的)，所以看到前面解析 json 字符串的例子捕获了这两种异常。

例：前面解析字符串的例子，在 Memo1 里面输入不合理的 json 内容，测试一下程序运行的结果：

"value": a1234.56 提示 json 解析错误，分析原因 a1234.56 不是数字，字符串需要有引号，在解析 json 的时候就出错了，没有抛出异常。

"value": a1234.56 解析错误，没有抛出异常

"value": "1234.56" 读取为 double 时抛出异常，分析原因，解析 json 时认为这是一个字符串值，解析 json 通过，但是读取时，由于这是字符串值，读成 double 时类型错误，抛出异常。

"value": "1234.56" 读取为 double 时抛出异常

五. 判断 Json::Value 的类型

在读取 Json::Value 值的时候，如果类型错误就会抛出异常，所以在不确定类型的情况下，需要判断类型。

Json::Value 的 type() 方法返回的是 Json::Value 的类型。

Json::Value 还有一些其他的判断类型的方法：

六. 下载本文例子

请点击：jsoncpp-master-1.9.3-src-cbuilder 下载 jsoncpp-master 1.9.3 源码、C++ Builder 项目文件，编译好了的库文件、例子程序等。

参考：

• C++ Builder 编译 jsoncpp 库 (0.y.z 分支)
• C++ Builder 编译 jsoncpp 库 (master 分支)
• C++ Builder 解析和生成 json (使用 jsoncpp (0.y.z))
• C++ Builder 解析 json，Json::CharReaderBuilder 的使用方法
• C++ Builder 生成 json，Json::StreamWriterBuilder 参数详解
• C++ Builder 遍历 json (使用 jsoncpp)