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 编译器的对钩去掉：
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 的成员函数：
| 函数 | 得到的值 |
|---|---|
| asBool() | 布尔型 bool |
| asInt() | 整型 int |
| asInt64() | 64位整型 long long |
| asUInt() | 无符号整型 unsigned int |
| asUInt64() | 64位无符号整型 unsigned long long |
| asLargestInt() | 最大位数的整型 intmax_t |
| asLargestUInt() | 最大位数的无符号整型 uintmax_t |
| asFloat() | 浮点数 float |
| asDouble() | 双精度浮点数 double |
| asString() | 字符串 std::string |
| asCString() | 字符串 const char * |
例：从 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_ptrjcReader(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 文件
只要把文件内容读到 UTF8String 里面就可以用前面的解析 json 字符串的方法解析了。
下面程序把 L"d:\\folder\\filename.txt" 读到 UTF8String txt 里面，按照 BOM 自动识别文件编码 UTF-8 / UNICODE 等，如果没有 BOM 会认为是 ANSI 编码 (由操作系统确定具体编码，Windows 10 新版在控制面板里面可以设为没有 BOM 认为是 UTF-8，否则认为是 ANSI)。
std::auto_ptrsl(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_ptrsl(new TStringList);
sl->LoadFromFile(L"d:\\folder\\filename.txt");
UTF8String txt = sl->Text;
Json::Value jsValue;
Json::String jsErrors;
Json::CharReaderBuilder jcrBuilder;
std::unique_ptrjcReader(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": "1234.56" 读取为 double 时抛出异常，分析原因，解析 json 时认为这是一个字符串值，解析 json 通过，但是读取时，由于这是字符串值，读成 double 时类型错误，抛出异常。
五. 判断 Json::Value 的类型
在读取 Json::Value 值的时候，如果类型错误就会抛出异常，所以在不确定类型的情况下，需要判断类型。
Json::Value 的 type() 方法返回的是 Json::Value 的类型。
| 类型枚举值 | 说明 |
|---|---|
| nullValue | NULL 值 |
| intValue | 有符号整数 |
| uintValue | 无符号整数 |
| realValue | 双精度浮点数 |
| stringValue | UTF-8 字符串 |
| booleanValue | 布尔值 |
| arrayValue | 数组 |
| objectValue | 一组 name/value 键值对 |
Json::Value 还有一些其他的判断类型的方法：
| 判断类型的方法 | 说明 |
|---|---|
| isNull() | 是 NULL 值 |
| isBool() | 是布尔值 |
| isNumeric() | 是数字 |
| isIntegral() | 是整数 |
| isInt() | 是有符号整数 |
| isInt64() | 是 64 位有符号整数 |
| isUInt() | 是无符号整数 |
| isUInt64() | 是 64 位无符号整数 |
| isDouble() | 是浮点数 |
| isString() | 是字符串 |
| isArray() | 是数组 |
| isObject() | 是 name/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)