介绍
RapidJSON是一个C++的高性能的JSON解析器及生成器,同时支持SAX/DOM风格的API。
项目详细介绍
RapidJSON是一个C++的JSON解析器及生成器。它的灵感来自RapidXml
RapidJSON小而全。它同时支持SAX和DOM风格的API。SAX解析器只有约500行代码
RapidJSON快。它的性能可与strlen()相比。可支持SSE2/SSE4.1加速
RapidJSON独立。它不依赖于BOOST等外部库。它甚至不依赖于STL
RapidJSON对内存友好。在大部分32/64位机器上,每个JSON值只占16或20字节(除字符串外)。它预设使用一个快速的内存分配器,令分析器可以紧凑地分配内存
RapidJSON对Unicode友好。它支持UTF-8、UTF-16、UTF-32 (大端序/小端序),并内部支持这些编码的检测、校验及转码。例如,RapidJSON可以在分析一个UTF-8文件至DOM时,把当中的JSON字符串转码至UTF-16。它也支持代理对(surrogate pair)及”\u0000”(空字符)
兼容性
RapidJSON是跨平台的。以下是一些曾测试的平台/编译器组合:
Visual C++ 2008/2010/2013 在 Windows (32/64-bit)
GNU C++ 3.8.x 在 Cygwin
Clang 3.4 在 Mac OS X (32/64-bit) 及 iOS
Clang 3.4 在 Android NDK
用户也可以在他们的平台上生成及执行单元测试。 ——腾讯开源
安装
Linux安装比较简单,将rapidjson
文件夹移动到/usr/include/
就可以使用了。
用法
每个 JSON 值都储存为 Value 类,而 Document 类则表示整个 DOM,它存储了一个 DOM 树的根 Value。RapidJSON 的所有公开类型及函数都在 rapidjson 命名空间中。
例如,有这样的JSONC语言字符串(被char *json
指向):
{
"hello": "world",
"t": true ,
"f": false,
"n": null,
"i": 123,
"pi": 3.1416,
"a": [1, 2, 3, 4]
}
DOM解析
Document document;
document.Parse(json);
会形成如下图的DOM树:
提供的对对应值的操作接口
1、判断Key值是否存在:HasMember("二狗");
2、判断value值的类型,命名比较规范,就不详述了,如下:
IsObject();IsBool();IsNull();IsNumber();
IsInt();IsDouble();IsArray();
3、获取和设置对应的值(参考第2点,将Is换作Get/Set)。
值得注意的是数组和对象值的获取需要通过循环。
示例
//json.txt
{
"hello": "world",
"t": true ,
"f": false,
"n": null,
"i": 123,
"pi": 3.1416,
"a": [1, 2, 3, 4]
}
/*************************************************************************
> File Name: test_json.cpp
> Author: vividwei
> Mail: [email protected]
> Created Time: 2016年12月15日 星期四 22时29分02秒
************************************************************************/
#include <iostream>
#include <string>
#include <fstream>
#include <rapidjson/document.h>
using namespace std;
using namespace rapidjson;
int main(void)
{
string buff;
string tmp;
ifstream res("json.txt");
if (!res.is_open())
{
┊ cerr << "open" << endl;
┊ return -1;
}
while (!res.eof())
{
┊ getline(res, tmp);
┊ buff.append(tmp+'\n');
}
Document document;
document.Parse(buff.c_str());
if (document["hello"].IsString())
{
┊ cout << document["hello"].GetString() << endl;
}
return 0;
}
总结
使用和测试就是这样了,使用比较简单。以后要是需要使用C++解析和生成JSON,可以考虑使用这个库。