Tencent is pleased to support the open source community by making RapidJSON available.
Copyright (C) 2015 THL A29 Limited, a Tencent company, and Milo Yip. All rights reserved.
RapidJSON is a JSON parser and generator for C++. It was inspired by RapidXml.
strlen(). It also optionally supports SSE2/SSE4.2 for acceleration.
More features can be read here.
RapidJSON is cross-platform. Some platform/compiler combinations which have been tested are shown as follows.
Users can build and run the unit tests on their platform/compiler.
RapidJSON is a header-only C++ library. Just copy the
include/rapidjson folder to system or project's include path.
RapidJSON uses following software as its dependencies:
To generate user documentation and run tests please proceed with the steps below:
git submodule update --initto get the files of thirdparty submodules (google test).
buildin rapidjson source directory.
builddirectory and run
cmake ..command to configure your build. Windows users can do the same with cmake-gui application.
makefrom the build directory.
On successfull build you will find compiled test and example binaries in
bin directory. The generated documentation will be available in
doc/html directory of the build tree. To run tests after finished build please run
make test or
ctest from your build tree. You can get detailed output using
ctest -V command.
It is possible to install library system-wide by running
make install command from the build tree with administrative privileges. This will install all files according to system preferences. Once RapidJSON is installed, it is possible to use it from other CMake projects by adding
find_package(RapidJSON) line to your CMakeLists.txt.
This simple example parses a JSON string into a document (DOM), make a simple modification of the DOM, and finally stringify the DOM to a JSON string.
Note that this example did not handle potential errors.
The following diagram shows the process.
More examples are available:
JsonxWriterwhich stringify SAX events into JSONx (a kind of XML) format. The example is a command line tool which converts input JSON into JSONx format.
AsyncDocumentParserwhich can parse JSON in parts, using C++11 thread.