jsoncpp 的 0.y.z 分支适用于早期版本的编译器，低版本的 C++ Builder 也可以使用。
下载和编译 jsoncpp 0.y.z 可以参考 《C++ Builder 编译 jsoncpp 库 (0.y.z 分支)》
master 分支的 jsoncpp 已经不使用本文的解析和生成 json 的方法了。
- 使用 jsoncpp 静态库
- 解析 json
· 解析 json 字符串
· 解析 json 文件 - 生成 json
· 一般格式 toStyledString
· 压缩格式 FastWriter
· 保存 json 文件 - 下载本文例子源码
一. 使用 jsoncpp 静态库
1. 下载和编译 jsoncpp 静态库
下载和编译 jsoncpp 0.y.z 可以参考 《C++ Builder 编译 jsoncpp 库 (0.y.z 分支)》
2. 在项目选项里面，添加头文件和库文件的路径
选择菜单 Project -> Options
头文件的路径需要添加这个文件夹：
库文件的路径需要添加这个文件夹：
3. 包含头文件和链接库文件
#include "json/json.h"
#if defined(__clang__) && (__POINTER_WIDTH__ == 64)
#pragma link "jsoncpp.a"
#else
#pragma link "jsoncpp.lib"
#endif
二. 解析 json
由于 jsoncpp 必须采用 UTF-8 编码，所以必须用 UTF8String 字符串类型。
1. 解析 json 字符串
使用 Json::Reader 解析 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; // Memo1 里面的文字转为 UTF-8 编码
Json::Reader jsReader;
Json::Value jsValue;
if(!jsReader.parse(txt.c_str(), jsValue))
{
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);
}
}
运行结果：
2. 解析 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 字符串的方法了。
三. 生成 json
1. 生成 json 字符串
例：要生成这样的 json：
{
"data" : 12345,
"error" : [
{
"描述" : "故障1",
"编码" : "101"
},
{
"描述" : "故障2",
"编码" : "102"
}
]
}
生成 json 的代码如下，把生成的 json 显示在 Memo2 里面。
void __fastcall TForm1::Button3Click(TObject *Sender)
{
Json::Value J;
J["data"] = 12345;
J["error"][0][UTF8String(L"编码").c_str()] = UTF8String(L"101" ).c_str();
J["error"][0][UTF8String(L"描述").c_str()] = UTF8String(L"故障1").c_str();
J["error"][1][UTF8String(L"编码").c_str()] = UTF8String(L"102" ).c_str();
J["error"][1][UTF8String(L"描述").c_str()] = UTF8String(L"故障2").c_str();
Memo2->Lines->LineBreak = L"\n"; // jsoncpp 的换行符是 "\n"
Memo2->Lines->Text = UTF8String(J.toStyledString().c_str());
Memo2->Lines->LineBreak = L"\r\n"; // 恢复 Windows 的换行符 "\r\n"
}
运行结果：
前面的代码是通过 json 根节点直接创建 json 字符串，下面代码是通过中间变量创建：
void __fastcall TForm1::Button4Click(TObject *Sender)
{
typedef struct
{
const wchar_t *sCode;
const wchar_t *sDesc;
} TErrorInfo;
static const TErrorInfo EInfo[] =
{
{ L"101", L"故障1" },
{ L"102", L"故障2" },
{ NULL , NULL },
};
Json::Value J;
J["data"] = 12345;
Json::Value &jsError = J["error"];
for(int i=0; EInfo[i].sCode; i++)
{
const TErrorInfo &EI = EInfo[i];
Json::Value &jsErrInfo = jsError[i];
jsErrInfo[UTF8String(L"编码").c_str()] = UTF8String(EI.sCode).c_str();
jsErrInfo[UTF8String(L"描述").c_str()] = UTF8String(EI.sDesc).c_str();
}
Memo2->Lines->LineBreak = L"\n"; // jsoncpp 的换行符是 "\n"
Memo2->Lines->Text = UTF8String(J.toStyledString().c_str());
Memo2->Lines->LineBreak = L"\r\n"; // 恢复 Windows 的换行符 "\r\n"
}
运行结果：
2. 一般格式 toStyledString
用 Json::Value 的 toStyledString() 方法得到的就是一般格式的 json 字符串，如前面例子的效果。
3. 压缩格式 FastWriter
如果生成的 json 字符串用于网络传输，用前面的 toStyledString() 方法得到的字符串有大量的空格和换行符，占用空间太大了，需要用压缩格式的 json 字符串，不包含没有必要的空格和换行符。
void __fastcall TForm1::Button5Click(TObject *Sender)
{
Json::Value J;
J["data"] = 12345;
J["error"][0][UTF8String(L"编码").c_str()] = UTF8String(L"101" ).c_str();
J["error"][0][UTF8String(L"描述").c_str()] = UTF8String(L"故障1").c_str();
J["error"][1][UTF8String(L"编码").c_str()] = UTF8String(L"102" ).c_str();
J["error"][1][UTF8String(L"描述").c_str()] = UTF8String(L"故障2").c_str();
Memo2->Lines->LineBreak = L"\n"; // jsoncpp 的换行符是 "\n"
Memo2->Lines->Text = UTF8String(Json::FastWriter().write(J).c_str());
Memo2->Lines->LineBreak = L"\r\n"; // 恢复 Windows 的换行符 "\r\n"
}
运行结果：
4. 保存 json 文件
4.1 例：生成一般格式的 UTF-8 编码的 json 文件
void __fastcall TForm1::Button6Click(TObject *Sender)
{
Json::Value J;
J["data"] = 12345;
J["error"][0][UTF8String(L"编码").c_str()] = UTF8String(L"101" ).c_str();
J["error"][0][UTF8String(L"描述").c_str()] = UTF8String(L"故障1").c_str();
J["error"][1][UTF8String(L"编码").c_str()] = UTF8String(L"102" ).c_str();
J["error"][1][UTF8String(L"描述").c_str()] = UTF8String(L"故障2").c_str();
std::auto_ptr<TStringList>sl(new TStringList);
sl->LineBreak = L"\n"; // jsoncpp 的换行符是 "\n"
sl->Text = UTF8String(J.toStyledString().c_str());
sl->LineBreak = L"\r\n"; // 恢复 Windows 的换行符 "\r\n"
sl->SaveToFile(L"d:\\test.txt", TEncoding::UTF8);
}
生成的文件用记事本打开查看内容：
4.2 生成压缩格式的 UTF-8 编码的 json 文件
void __fastcall TForm1::Button7Click(TObject *Sender)
{
Json::Value J;
J["data"] = 12345;
J["error"][0][UTF8String(L"编码").c_str()] = UTF8String(L"101" ).c_str();
J["error"][0][UTF8String(L"描述").c_str()] = UTF8String(L"故障1").c_str();
J["error"][1][UTF8String(L"编码").c_str()] = UTF8String(L"102" ).c_str();
J["error"][1][UTF8String(L"描述").c_str()] = UTF8String(L"故障2").c_str();
std::auto_ptr<TStringList>sl(new TStringList);
sl->Text = UTF8String(Json::FastWriter().write(J).c_str());
sl->SaveToFile(L"d:\\test.txt", TEncoding::UTF8);
}
生成的 json 文件用记事本打开查看内容：
四. 下载本文例子源码
请点击：jsoncpp-0.10.7-src-cbuilder 下载 jsoncpp 0.10.7 完整源码、C++ Builder 项目文件、编译好了的库文件、例子程序等。
参考：
