简介

RapidJSON是一个C++的JSON解析器及生成器。它的灵感来自RapidXml。

• RapidJSON小而全。它同时支持SAX和DOM风格的API。SAX解析器只有约500行代码。
• RapidJSON快。它的性能可与strlen()相比。可支持SSE2/SSE4.2加速。
• 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"（空字符）。

在这里可读取更多特点。

JSON（JavaScript Object Notation）是一个轻量的数据交换格式。RapidJSON应该完全遵从RFC7159/ECMA-404。 关于JSON的更多信息可参考：

• Introducing JSON
• RFC7159: The JavaScript Object Notation (JSON) Data Interchange Format
• Standard ECMA-404: The JSON Data Interchange Format

兼容性

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

用户也可以在他们的平台上生成及执行单元测试。

安装

RapidJSON是只有头文件的C++库。只需把include/rapidjson目录复制至系统或项目的include目录中。

生成测试及例子的步骤：

1. 执行git submodule update --init去获取 thirdparty submodules (google test)。
2. 下载 premake4。
3. 复制 premake4 可执行文件至rapidjson/build（或系统路径）。
4. 进入rapidjson/build/目录，在Windows下执行premake.bat，在Linux或其他平台下执行premake.sh。
5. 在Windows上，生成位于rapidjson/build/vs2008/或/vs2010/内的项目方案.
6. 在其他平台上，在rapidjson/build/gmake/目录执行GNUmake（如make -f test.make config=release32、make -f example.make config=debug32）。
7. 若成功，可执行文件会生成在rapidjson/bin目录。

生成Doxygen文档的步骤：

1. 下载及安装Doxygen。
2. 在顶层目录执行doxygen build/Doxyfile。
3. 在doc/html浏览文档。

用法一览

此简单例子解析一个JSON字符串至一个document (DOM)，对DOM作出简单修改，最终把DOM转换（stringify）至JSON字符串。

// rapidjson/example/simpledom/simpledom.cpp`  #include "rapidjson/document.h"  #include "rapidjson/writer.h"  #include "rapidjson/stringbuffer.h"  #include <iostream>  using namespace rapidjson;  int main() {      // 1. 把JSON解析至DOM。      const char* json = "{\"project\":\"rapidjson\",\"stars\":10}";      Document d;      d.Parse(json);      // 2. 利用DOM作出修改。      Value& s = d["stars"];      s.SetInt(s.GetInt() + 1);      // 3. 把DOM转换（stringify）成JSON。      StringBuffer buffer;      Writer<StringBuffer> writer(buffer);      d.Accept(writer);      // Output {"project":"rapidjson","stars":11}      std::cout << buffer.GetString() << std::endl;      return 0;  }

注意此例子并没有处理潜在错误。

下图展示执行过程。

项目主页：http://www.open-open.com/lib/view/home/1429837362276