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_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 字符串的方法了。
三. 生成 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_ptrsl(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_ptrsl(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 项目文件、编译好了的库文件、例子程序等。
参考:
- 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)