rapidjson官方开发文档中文版

《rapidjson官方开发文档中文版》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、TableofContentsIntroduction1.1特点1.2教程1.3Pointer1.4流1.5编码1.6DOM1.7SAX1.8Schema1.9性能1.10Internals1.11常见问题1.121Introduction高效的C++JSON解析／生成器，提供SAX及DOM风格APITencentispleasedtosupporttheopensourcecommunitybymakingRapidJSONavailable.Copyright(C)2015THLA29Limited,aTencentcompany,andMiloYip.Allrightsreserved

2、.RapidJSONGitHubRapidJSON文档English简体中文GitBook可下载PDF/EPUB/MOBI，但不含API参考手册。Build状态LinuxWindowsCoveralls简介RapidJSON是一个C++的JSON解析器及生成器。它的灵感来自RapidXml。RapidJSON小而全。它同时支持SAX和DOM风格的API。SAX解析器只有约500行代码。RapidJSON快。它的性能可与strlen()相比。可支持SSE2/SSE4.2加速。RapidJSON独立。它不依赖于BOOST等外部库。它甚至不依赖于STL。RapidJSON对内存友好。在大部分32/

3、64位机器上，每个JSON值只占16字节（除字符串外）。它预设使用一个快速的内存分配器，令分析器可以紧凑地分配内存。RapidJSON对Unicode友好。它支持UTF-8、UTF-16、UTF-32(大端序／小端序)，并内部支持这些编码的检测、校验及转码。例如，RapidJSON可以在分析一个UTF-8文件至DOM时，把当中的JSON字符串转码至UTF-16。它也支持代理对（surrogatepair）及"u0000"（空字符）。在这里可读取更多特点。JSON（JavaScriptObjectNotation）是一个轻量的数据交换格式。RapidJSON应该完全遵从RFC7159/ECM

4、A-404，并支持可选的放宽语法。关于JSON的更多信息可参考：IntroducingJSONRFC7159:TheJavaScriptObjectNotation(JSON)DataInterchangeFormatStandardECMA-404:TheJSONDataInterchangeFormatv1.1中的亮点(2016-8-25)2Introduction加入JSONPointer功能，可更简单地访问及更改DOM。加入JSONSchema功能，可在解析或生成JSON时进行校验。加入放宽的JSON语法（注释、尾随逗号、NaN/Infinity）使用C++11范围for循环去遍历a

5、rray和object。在x86-64架构下，缩减每个Value的内存开销从24字节至16字节。其他改动请参考changelog.兼容性RapidJSON是跨平台的。以下是一些曾测试的平台／编译器组合：VisualC++2008/2010/2013在Windows(32/64-bit)GNUC++3.8.x在CygwinClang3.4在MacOSX(32/64-bit)及iOSClang3.4在AndroidNDK用户也可以在他们的平台上生成及执行单元测试。安装RapidJSON是只有头文件的C++库。只需把include/rapidjson目录复制至系统或项目的include目录中。Ra

6、pidJSON依赖于以下软件：CMake作为通用生成工具(optional)Doxygen用于生成文档(optional)googletest用于单元及性能测试生成测试及例子的步骤：1.执行gitsubmoduleupdate--init去获取thirdpartysubmodules(googletest)。2.在rapidjson目渌下，建立一个build目录。3.在build目录下执行cmake..命令以设置生成。Windows用户可使用cmake-gui应用程序。4.在Windows下，编译生成在build目录中的solution。在Linux下，于build目录运行make。成功生成

7、后，你会在bin的目录下找到编译后的测试及例子可执行文件。而生成的文档将位于build下的doc/html目录。要执行测试，请在build下执行maketest或ctest。使用ctest-V命令可获取详细的输出。我们也可以把程序库安装至全系统中，只要在具管理權限下从build目录执行makeinstall命令。这样会按系统的偏好设置安装所有文件。当安装RapidJSON后，其他的CMake项目需要使用它时，