rapidjson常见使用示例

Love The Way You Lie 2022-03-22 14:17 878阅读 0赞

# **目录** #

目录 1

1. 前言 2

2. Move语意 2

3. rapidjson::Document 2

4. 内存泄漏 3

5. 成员迭代器MemberIterator 4

6. 数组迭代器ValueIterator 4

7. \#include头文件 5

8. 示例1：解析一个字符串 5

9. 示例2：构造一个json并转成字符串 7

10. 示例3：修改一个已有的json字符串 8

11. 示例4：读数组 8

12. 示例5: 以Writer构造一个json，然后修改它，最后转成字符串 9

13. 示例6: 以Document构造一个json，然后修改它，最后转成字符串 10

14. 示例7: 以Document构造一个json，然后修改它，最后转成字符串 12

15. 示例8：构造空对象和数组 12

16. 示例9：删除数组元素 14

17. 示例10：不转义中文 15

18. 示例11：schema使用示例 16

19. 示例12：schema完整示例 18

20. FindMember整数值 19

21. FindMember字符串值 19

22. 遍历成员 19

23. 遍历数组1：字符串数组 19

24. 遍历数组2：一级对象数组 20

25. 遍历数组3：两级对象数组 21

26. 辅助函数1：任意类型都以字符串返回 21

27. 辅助函数2：取int32\_t值 22

28. 辅助函数3：取int64\_t值 23

29. 辅助函数4：取uint32\_t值 24

30. 辅助函数5：取uint64\_t值 24

31. 辅助函数6：对象转字符串 25

32. 辅助函数7：字符串转对象 25

33. rapidjson的“坑” 26

1.   **前言**

rapidjson相比jsoncpp性能高出太多，使用接口一样的简单的。官方中文帮助文档：[RapidJSON: 首页][RapidJSON_]。

1.   **Move语意**

rapidjson的Move语意，请浏览：

[RapidJSON: 教程][RapidJSON_ 1]。

示例：

除了上述示例的复制语句外，AddMember()和PushBack()也采用了Move语意。深复制Value：

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> Value v1("foo"); // Value v2(v1); // 不容许 Value v2(v1, a); // 制造一个克隆，v1不变 Document d; v2.CopyFrom(d, a); // 把整个document复制至v2，d不变 </td> 
 </tr> 
 </tbody> 
</table>

rapidjson为了最大化性能，大量使用了浅拷贝，使用之前一定要了解清楚。如果采用了浅拷贝，特别要注意局部对象的使用，以防止对象已被析构了，却还在被使用。

1.   **rapidjson::Document**

特别注意rapidjson::Document可以为object、array、number、string、boolean和null中任意一种类型。只有为object时才可以调用HasMember等与object有关的方法。

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> #include &lt;rapidjson/document.h&gt; #include &lt;rapidjson/error/en.h&gt; #include &lt;rapidjson/stringbuffer.h&gt; #include &lt;rapidjson/writer.h&gt; #include &lt;stdio.h&gt; int main(int argc, char* argv[]) { &nbsp;&nbsp;&nbsp;&nbsp;std::string str; &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Document doc; &nbsp;&nbsp;&nbsp;&nbsp;doc.Parse(argv[1]); &nbsp;&nbsp;&nbsp;&nbsp;if (doc.HasParseError()) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;printf("parse error\n"); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;// 注意doc可为object, array, number, string, boolean, null中任意一种类型 &nbsp;&nbsp;&nbsp;&nbsp;if (!doc.IsObject()) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;printf("not object\n"); &nbsp;&nbsp;&nbsp;&nbsp;else &nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;printf("parse ok\n"); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if (doc.IsNumber()) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;printf("%d\n", doc.GetInt()); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// doc为object类型时，才能调用HasMember &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if (doc.HasMember("x")) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;printf("has x\n"); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;else &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;printf("without x\n"); &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;return 0; } </td> 
 </tr> 
 </tbody> 
</table>

1.   **内存泄漏**

两种使用，Rapidjson会产生内存泄漏：

1.  重复使用Document对象

重复使用Document可能导致内存泄漏，如下段代码即存在内存泄漏：

参考：[https://github.com/Tencent/rapidjson/issues/1333][https_github.com_Tencent_rapidjson_issues_1333]。解决办法：

1.  使用Value类型指针

把Document类型指针当Value类型指针使用，出现内存泄漏，原因是Value的析构不是虚拟的，打开-Wall编译器也不会告警。

1.   **成员迭代器MemberIterator**

成员迭代器rapidjson::Value::**MemberIterator**实际指向GenericMember：

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> template &lt;typename Encoding, typename Allocator&gt; struct GenericMember { &nbsp;&nbsp;&nbsp;&nbsp;// 成员名，只能为string值 &nbsp;&nbsp;&nbsp;&nbsp;GenericValue&lt;Encoding, Allocator&gt; name; &nbsp;&nbsp;&nbsp;&nbsp;// 成员值，可为各类类型，如字符串、数组、子对象等 &nbsp;&nbsp;&nbsp;&nbsp;GenericValue&lt;Encoding, Allocator&gt; value; }; typedef typename GenericMemberIterator&lt;false,Encoding,Allocator&gt;::Iterator MemberIterator; class GenericMemberIterator { &nbsp;&nbsp;&nbsp;&nbsp;typedef GenericMember&lt;Encoding,Allocator&gt; PlainType; &nbsp;&nbsp;&nbsp;&nbsp;typedef typename internal::MaybeAddConst&lt;Const,PlainType&gt;::Type ValueType; &nbsp;&nbsp;&nbsp;&nbsp;typedef std::iterator&lt;std::random_access_iterator_tag,ValueType&gt; BaseType; &nbsp;&nbsp;&nbsp;&nbsp;typedef GenericMemberIterator Iterator; &nbsp;&nbsp;&nbsp;&nbsp;// Pointer to (const) GenericMember &nbsp;&nbsp;&nbsp;&nbsp;typedef typename BaseType::pointer Pointer; &nbsp;&nbsp;&nbsp;&nbsp;Pointer ptr_; // raw pointer &nbsp;&nbsp;&nbsp;&nbsp;Pointer &nbsp;&nbsp;operator-&gt;() const { return ptr_; } }; </td> 
 </tr> 
 </tbody> 
</table>

1.   **数组迭代器ValueIterator**

数组迭代器ValueIterator实际为GenericValue指针：

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> typedef GenericValue* ValueIterator; typedef const GenericValue* ConstValueIterator; </td> 
 </tr> 
 </tbody> 
</table>

1.   **\#include头文件**

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> // 需要#include的头文件： #include &lt;rapidjson/document.h&gt; #include &lt;rapidjson/error/en.h&gt; #include &lt;rapidjson/stringbuffer.h&gt; #include &lt;rapidjson/writer.h&gt; </td> 
 </tr> 
 </tbody> 
</table>

其中en为english的简写，定义了取出错信息的函数GetParseError\_En(errcode)。

1.   **示例1：解析一个字符串**

1.  运行输出结果

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> count=2 name=zhangsan name=wangwu </td> 
 </tr> 
 </tbody> 
</table>

1.  示例代码

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> void x1() { &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Document document; // 定义一个Document对象 &nbsp;&nbsp;&nbsp;&nbsp;std::string str = "{\"count\":2,\"names\":[\"zhangsan\",\"wangwu\"]}"; &nbsp;&nbsp;&nbsp;&nbsp;document.Parse(str.c_str()); // 解析，Parse()无返回值，也不会抛异常 &nbsp;&nbsp;&nbsp;&nbsp;if (document.HasParseError()) // 通过HasParseError()来判断解析是否成功 &nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// 可通过GetParseError()取得出错代码， &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// 注意GetParseError()返回的是一个rapidjson::ParseErrorCode类型的枚举值 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// 使用函数rapidjson::GetParseError_En()得到错误码的字符串说明，这里的En为English简写 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// 函数GetErrorOffset()返回出错发生的位置 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;printf("parse error: (%d:%d)%s\n", document.GetParseError(), document.GetErrorOffset(), rapidjson::GetParseError_En(document.GetParseError())); &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;else &nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// 判断某成员是否存在 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if (!document.HasMember("count") || !document.HasMember("names")) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;printf("invalid format: %s\n", str.c_str()); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;else &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// 如果count不存在，则运行程序会挂，DEBUG模式下直接abort &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Value&amp; count_json = document["count"]; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// 如果count不是整数类型，调用也会挂，DEBUG模式下直接abort &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// GetInt()返回类型为int &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// GetUint()返回类型为unsigned int &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// GetInt64()返回类型为int64_t &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// GetUint64()返回类型为uint64_t &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// GetDouble()返回类型为double &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// GetString()返回类型为char* &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// GetBool()返回类型为bool &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;int count = count_json.GetInt(); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;printf("count=%d\n", count); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// 方法GetType()返回枚举值: kNullType,kFalseType,kTrueType,kObjectType,kArrayType,kStringType,kNumberType &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// 可用IsArray()判断是否为数组，示例: { "a": [1, 2, 3, 4] } &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// 用IsString()判断是否为字符串值 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// 用IsDouble()判断是否为double类型的值，示例: { "pi": 3.1416 } &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// 用IsInt()判断是否为int类型的值 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// 用IsUint()判断是否为unsigned int类型的值 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// 用IsInt64()判断是否为int64_t类型的值 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// 用IsUint64()判断是否为uint64_t类型的值 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// 用IsBool()判断是否为bool类型的值 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// 用IsFalse()判断值是否为false，示例: { "t": true, "f": false } &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// 用IsTrue()判断值是否为true &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// 用IsNull()判断值是否为NULL，示例: { "n": null } &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// 更多说明可浏览： &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// https://miloyip.gitbooks.io/rapidjson/content/zh-cn/doc/tutorial.zh-cn.html &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;const rapidjson::Value&amp; names_json = document["names"]; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;for (rapidjson::SizeType i=0; i&lt;names_json.Size(); ++i) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;std::string name = names_json[i].GetString(); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;printf("name=%s\n", name.c_str()); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;} } </td> 
 </tr> 
 </tbody> 
</table>

1.   **示例2：构造一个json并转成字符串**

1.  运行输出结果

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> {"count":2,"names":[{"name":"zhangsan"},{"name":"wangwu"}]} </td> 
 </tr> 
 </tbody> 
</table>

1.  示例代码

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> void x2() { &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::StringBuffer buffer; &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Writer&lt;rapidjson::StringBuffer&gt; writer(buffer); &nbsp;&nbsp;&nbsp;&nbsp;writer.StartObject(); &nbsp;&nbsp;&nbsp;&nbsp;// count &nbsp;&nbsp;&nbsp;&nbsp;writer.Key("count"); &nbsp;&nbsp;&nbsp;&nbsp;writer.Int(2); &nbsp;&nbsp;&nbsp;&nbsp;// 写4字节有符号整数: Int(int32_t x) &nbsp;&nbsp;&nbsp;&nbsp;// 写4字节无符号整数: Uint(uint32_t x) &nbsp;&nbsp;&nbsp;&nbsp;// 写8字节有符号整数: Int64(int64_t x) &nbsp;&nbsp;&nbsp;&nbsp;// 写8字节无符号整数: Uint64(uint64_t x) &nbsp;&nbsp;&nbsp;&nbsp;// 写double值: Double(double x) &nbsp;&nbsp;&nbsp;&nbsp;// 写bool值: Bool(bool x) &nbsp;&nbsp;&nbsp;&nbsp;// names &nbsp;&nbsp;&nbsp;&nbsp;writer.Key("names"); &nbsp;&nbsp;&nbsp;&nbsp;writer.StartArray(); &nbsp;&nbsp;&nbsp;&nbsp;writer.StartObject(); &nbsp;&nbsp;&nbsp;&nbsp;writer.Key("name"); &nbsp;&nbsp;&nbsp;&nbsp;writer.String("zhangsan"); &nbsp;&nbsp;&nbsp;&nbsp;writer.EndObject(); &nbsp;&nbsp;&nbsp;&nbsp;writer.StartObject(); &nbsp;&nbsp;&nbsp;&nbsp;writer.Key("name"); &nbsp;&nbsp;&nbsp;&nbsp;writer.String("wangwu"); &nbsp;&nbsp;&nbsp;&nbsp;writer.EndObject(); &nbsp;&nbsp;&nbsp;&nbsp;writer.EndArray(); &nbsp;&nbsp;&nbsp;&nbsp;writer.EndObject(); &nbsp;&nbsp;&nbsp;&nbsp;// 以字符串形式打印输出 &nbsp;&nbsp;&nbsp;&nbsp;printf("%s\n", buffer.GetString()); } </td> 
 </tr> 
 </tbody> 
</table>

1.   **示例3：修改一个已有的json字符串**

1.  运行输出结果

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> {"name":"wangwu","age":22} </td> 
 </tr> 
 </tbody> 
</table>

1.  示例代码

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> void x3() { &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Document document; &nbsp;&nbsp;&nbsp;&nbsp;std::string str = "{\"name\":\"zhangsan\",\"age\":20}"; &nbsp;&nbsp;&nbsp;&nbsp;document.Parse(str.c_str()); &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Value&amp; name_json = document["name"]; &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Value&amp; age_json = document["age"]; &nbsp;&nbsp;&nbsp;&nbsp;std::string new_name = "wangwu"; &nbsp;&nbsp;&nbsp;&nbsp;int new_age = 22; &nbsp;&nbsp;&nbsp;&nbsp;// 注意第三个参数是document.GetAllocator()，相当于深拷贝，rapidjson会分配一块内存，然后复制new_name.c_str()， &nbsp;&nbsp;&nbsp;&nbsp;// 如果不指定第三个参数，则是浅拷贝，也就是rapidjson不会分配一块内存，而是直接指向new_name.c_str()，省去复制提升了性能 &nbsp;&nbsp;&nbsp;&nbsp;// 官方说明： &nbsp;&nbsp;&nbsp;&nbsp;// http://rapidjson.org/zh-cn/md_doc_tutorial_8zh-cn.html#CreateString &nbsp;&nbsp;&nbsp;&nbsp;name_json.SetString(new_name.c_str(), new_name.size(), document.GetAllocator()); &nbsp;&nbsp;&nbsp;&nbsp;age_json.SetInt(new_age); &nbsp;&nbsp;&nbsp;&nbsp;// 转成字符串输出 &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::StringBuffer buffer; &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Writer&lt;rapidjson::StringBuffer&gt; writer(buffer); &nbsp;&nbsp;&nbsp;&nbsp;document.Accept(writer); &nbsp;&nbsp;&nbsp;&nbsp;printf("%s\n", buffer.GetString()); } </td> 
 </tr> 
 </tbody> 
</table>

1.   **示例4：读数组**

1.  运行输出结果

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> zhangsan wangwu </td> 
 </tr> 
 </tbody> 
</table>

1.  示例代码

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> void x4() { &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Document document; &nbsp;&nbsp;&nbsp;&nbsp;std::string str = "{\"count\":2,\"names\":[{\"name\":\"zhangsan\"},{\"name\":\"wangwu\"}]}"; &nbsp;&nbsp;&nbsp;&nbsp;document.Parse(str.c_str()); &nbsp;&nbsp;&nbsp;&nbsp;if (document.HasParseError()) &nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;printf("parse error: %d\n", document.GetParseError()); &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;else &nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Value&amp; names_json = document["names"]; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;for (rapidjson::SizeType i=0; i&lt;names_json.Size(); ++i) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if (names_json[i].HasMember("name")) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Value&amp; name_json = names_json[i]["name"]; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;printf("%s ", name_json.GetString()); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;printf("\n"); &nbsp;&nbsp;&nbsp;&nbsp;} } </td> 
 </tr> 
 </tbody> 
</table>

1.   **示例5: 以Writer构造一个json，然后修改它，最后转成字符串**

1.  运行输出结果

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> {"count":2} {"count":8} </td> 
 </tr> 
 </tbody> 
</table>

1.  示例代码

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> void x5() { &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::StringBuffer buffer1; &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Writer&lt;rapidjson::StringBuffer&gt; writer1(buffer1); &nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;writer1.StartObject(); &nbsp;&nbsp;&nbsp;&nbsp;writer1.Key("count"); &nbsp;&nbsp;&nbsp;&nbsp;writer1.Int(2); &nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;writer1.EndObject(); &nbsp;&nbsp;&nbsp;&nbsp;printf("%s\n", buffer1.GetString()); &nbsp;&nbsp;&nbsp;&nbsp;// 转成Document对象 &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Document document; &nbsp;&nbsp;&nbsp;&nbsp;document.Parse(buffer1.GetString()); &nbsp;&nbsp;&nbsp;&nbsp;// 修改 &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Value&amp; count_json = document["count"]; &nbsp;&nbsp;&nbsp;&nbsp;count_json.SetInt(8); &nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;// 转成字符串 &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::StringBuffer buffer2; &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Writer&lt;rapidjson::StringBuffer&gt; writer2(buffer2); &nbsp;&nbsp;&nbsp;&nbsp;document.Accept(writer2); &nbsp;&nbsp;&nbsp;&nbsp;printf("%s\n", buffer2.GetString()); } </td> 
 </tr> 
 </tbody> 
</table>

1.   **示例6: 以Document构造一个json，然后修改它，最后转成字符串**

1.  运行输出结果

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> {"count":3,"names":[{"id":1,"name":"zhangsan"}]} {"count":9,"names":[{"id":1,"name":"zhangsan"}]} </td> 
 </tr> 
 </tbody> 
</table>

1.  示例代码

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> void x6() { &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Document document; &nbsp;&nbsp;&nbsp;&nbsp;std::string str = "{}"; // 这个是必须的，且不能为""，否则Parse出错 &nbsp;&nbsp;&nbsp;&nbsp;document.Parse(str.c_str()); &nbsp;&nbsp;&nbsp;&nbsp;// 新增成员count &nbsp;&nbsp;&nbsp;&nbsp;// AddMember第一个参数可以为字符串常，如“str”，不能为“const char*”和“std::string”， &nbsp;&nbsp;&nbsp;&nbsp;// 如果使用“const char*”，则需要使用StringRefType转换：StringRefType(str.c_str()) &nbsp;&nbsp;&nbsp;&nbsp;document.AddMember("count", 3, document.GetAllocator()); &nbsp;&nbsp;&nbsp;&nbsp;// 新增数组成员 &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Value array(rapidjson::kArrayType); &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Value object(rapidjson::kObjectType); // 数组成员 &nbsp;&nbsp;&nbsp;&nbsp;object.AddMember("id", 1, document.GetAllocator()); &nbsp;&nbsp;&nbsp;&nbsp;object.AddMember("name", "zhangsan", document.GetAllocator()); &nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;// 如果数组添加无名字的成员，定义Value时应当改成相应的类型，如： &nbsp;&nbsp;&nbsp;&nbsp;//rapidjson::Value value(rapidjson::kStringType); &nbsp;&nbsp;&nbsp;&nbsp;//rapidjson::Value value(rapidjson::kNumberType); &nbsp;&nbsp;&nbsp;&nbsp;//rapidjson::Value value(rapidjson::kFalseType); &nbsp;&nbsp;&nbsp;&nbsp;//rapidjson::Value value(rapidjson::kTrueType); &nbsp;&nbsp;&nbsp;&nbsp;//array.PushBack(value, document.GetAllocator()); &nbsp;&nbsp;&nbsp;&nbsp;//效果将是这样：'array':[1,2,3,4,5] &nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;// 注意下面用法编译不过: &nbsp;&nbsp;&nbsp;&nbsp;//std::string str1 = "hello"; &nbsp;&nbsp;&nbsp;&nbsp;//object.AddMember("name", str1.c_str(), document.GetAllocator()); &nbsp;&nbsp;&nbsp;&nbsp;//const char* str2 = "hello"; &nbsp;&nbsp;&nbsp;&nbsp;//object.AddMember("name", str2, document.GetAllocator()); &nbsp;&nbsp;&nbsp;&nbsp;// &nbsp;&nbsp;&nbsp;&nbsp;// 下面这样可以: &nbsp;&nbsp;&nbsp;&nbsp;//object.AddMember("name", "hello", document.GetAllocator()); &nbsp;&nbsp;&nbsp;&nbsp;//const char str3[] = "hello"; &nbsp;&nbsp;&nbsp;&nbsp;//object.AddMember("name", str3, document.GetAllocator()); &nbsp;&nbsp;&nbsp;&nbsp;// &nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;//std::string str4 = "#####"; &nbsp;&nbsp;&nbsp;&nbsp;//rapidjson::Value v(str4.c_str(), document.GetAllocator()); &nbsp;&nbsp;&nbsp;&nbsp;//obj.AddMember("x", v, document.GetAllocator()); &nbsp;&nbsp;&nbsp;&nbsp;// 上面两行也可以写在一行： &nbsp;&nbsp;&nbsp;&nbsp;//obj.AddMember("x", rapidjson::Value(str4.c_str(), document.GetAllocator()).Move(), document.GetAllocator()); &nbsp;&nbsp;&nbsp;&nbsp;// 添加到数组中 &nbsp;&nbsp;&nbsp;&nbsp;array.PushBack(object, document.GetAllocator()); &nbsp;&nbsp;&nbsp;&nbsp;// 添加到document中 &nbsp;&nbsp;&nbsp;&nbsp;document.AddMember("names", array, document.GetAllocator()); &nbsp;&nbsp;&nbsp;&nbsp;// 转成字符串输出 &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::StringBuffer buffer1; &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Writer&lt;rapidjson::StringBuffer&gt; writer1(buffer1); &nbsp;&nbsp;&nbsp;&nbsp;document.Accept(writer1); &nbsp;&nbsp;&nbsp;&nbsp;printf("%s\n", buffer1.GetString()); &nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;// 修改值 &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Value&amp; count_json = document["count"]; &nbsp;&nbsp;&nbsp;&nbsp;count_json.SetInt(9); &nbsp;&nbsp;&nbsp;&nbsp;// 再次输出 &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::StringBuffer buffer2; &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Writer&lt;rapidjson::StringBuffer&gt; writer2(buffer2); &nbsp;&nbsp;&nbsp;&nbsp;document.Accept(writer2); &nbsp;&nbsp;&nbsp;&nbsp;printf("%s\n", buffer2.GetString()); } </td> 
 </tr> 
 </tbody> 
</table>

1.   **示例7: 以Document构造一个json，然后修改它，最后转成字符串**

1.  运行输出结果（不转义就输出）

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> x7=&gt; {"title":"\u8D2B\u56F0\u5B64\u513F\u52A9\u517B"} </td> 
 </tr> 
 </tbody> 
</table>

1.  示例代码

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> void x7() { &nbsp;&nbsp;&nbsp;&nbsp;std::string root = "{}"; &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Document document; &nbsp;&nbsp;&nbsp;&nbsp;document.Parse(root.c_str()); &nbsp;&nbsp;&nbsp;&nbsp;std::string title = "\u8D2B\u56F0\u5B64\u513F\u52A9\u517B"; &nbsp;&nbsp;&nbsp;&nbsp;document.AddMember("title", rapidjson::Value(title.c_str(), document.GetAllocator()).Move(), document.GetAllocator()); &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::StringBuffer buffer; &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Writer&lt;rapidjson::StringBuffer, rapidjson::Document::EncodingType, rapidjson::ASCII&lt;&gt; &gt; writer(buffer); &nbsp;&nbsp;&nbsp;&nbsp;// 如果上面一句改成普通的： &nbsp;&nbsp;&nbsp;&nbsp;// rapidjson::Writer&lt;rapidjson::StringBuffer&gt; writer(buffer); &nbsp;&nbsp;&nbsp;&nbsp;// 则输出将变成： &nbsp;&nbsp;&nbsp;&nbsp;// x7=&gt; &nbsp;&nbsp;&nbsp;&nbsp;// 贫困孤儿助养 &nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;document.Accept(writer); &nbsp;&nbsp;&nbsp;&nbsp;printf("x7=&gt;\n%s\n", buffer.GetString()); } </td> 
 </tr> 
 </tbody> 
</table>

1.   **示例8：构造空对象和数组**

1.  运行输出结果

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> {"age":{},"times":{},"names":[],"urls":[],"books":[]} {"age":6,"times":{},"names":[],"urls":[],"books":[]} </td> 
 </tr> 
 </tbody> 
</table>

1.  示例代码

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> void x8() { &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Document document; &nbsp;&nbsp;&nbsp;&nbsp;document.Parse("{}"); // 这里换成document.SetObject()也可以 &nbsp;&nbsp;&nbsp;&nbsp;// 下面为2种构造空对象的方法 &nbsp;&nbsp;&nbsp;&nbsp;document.AddMember("age", rapidjson::Value(rapidjson::kObjectType).Move(), document.GetAllocator()); &nbsp;&nbsp;&nbsp;&nbsp;document.AddMember("times", rapidjson::Value().SetObject(), document.GetAllocator()); &nbsp;&nbsp;&nbsp;&nbsp;// 下面为2种构造空数组的方法 &nbsp;&nbsp;&nbsp;&nbsp;document.AddMember("names", rapidjson::Value(rapidjson::kArrayType).Move(), document.GetAllocator()); &nbsp;&nbsp;&nbsp;&nbsp;document.AddMember("urls", rapidjson::Value(rapidjson::kArrayType).Move(), document.GetAllocator()); &nbsp;&nbsp;&nbsp;&nbsp;document.AddMember("books", rapidjson::Value().SetArray(), document.GetAllocator()); &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::StringBuffer buffer1; &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Writer&lt;rapidjson::StringBuffer&gt; writer1(buffer1); &nbsp;&nbsp;&nbsp;&nbsp;document.Accept(writer1); &nbsp;&nbsp;&nbsp;&nbsp;printf("%s\n", buffer1.GetString()); &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Value&amp; age = document["age"]; &nbsp;&nbsp;&nbsp;&nbsp;age.SetInt(6); &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::StringBuffer buffer2; &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Writer&lt;rapidjson::StringBuffer&gt; writer2(buffer2); &nbsp;&nbsp;&nbsp;&nbsp;document.Accept(writer2); &nbsp;&nbsp;&nbsp;&nbsp;printf("%s\n", buffer2.GetString()); } </td> 
 </tr> 
 </tbody> 
</table>

以一个文档构建新的文档：

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> void tojson(std::string* jsonstr, const std::vector&lt;std::string&gt;&amp; values) { &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Document doc; &nbsp;&nbsp;&nbsp;&nbsp;doc.Parse("{}"); &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Value data_array(rapidjson::kArrayType); &nbsp;&nbsp;&nbsp;&nbsp;for (auto value: values) &nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// 注意 subdoc 的构造需要传入 doc 的 Allocator &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Document subdoc(&amp;doc.GetAllocator()); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if (subdoc.Parse(value.c_str()).HasParseError()) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;MYLOG_ERROR("[INVALID_FORMAT] %s\n", value.c_str()); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;else &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// 下列是个浅拷贝，执行完 PushBack 后，不能在使用 subdoc， &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// 如果想继续使用 subdoc，则应当改成调用： &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// data_array.PushBack(subdoc.Move(), doc.GetAllocator()); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;data_array.PushBack(subdoc, doc.GetAllocator()); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;} // for &nbsp;&nbsp;&nbsp;&nbsp;doc.AddMember("num", data_array.Size(), doc.GetAllocator()); &nbsp;&nbsp;&nbsp;&nbsp;doc.AddMember("data", data_array, doc.GetAllocator()); &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::StringBuffer buffer; &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Writer&lt;rapidjson::StringBuffer&gt; writer(buffer); &nbsp;&nbsp;&nbsp;&nbsp;doc.Accept(writer); &nbsp;&nbsp;&nbsp;&nbsp;jsonstr-&gt;assign(buffer.GetString(), buffer.GetSize()); } </td> 
 </tr> 
 </tbody> 
</table>

1.   **示例9：删除数组元素**

1.  运行输出结果

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> { "names": [ {"name":"zhangsan","age":100}, {"name":"wangwu","age":90}, {"name":"xiaozhang","age":20} ]} {"names":[{"name":"zhangsan","age":100},{"name":"wangwu","age":90}]} </td> 
 </tr> 
 </tbody> 
</table>

1.  示例代码

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> void x9() { &nbsp;&nbsp;&nbsp;&nbsp;std::string str = "{ \"names\": [ {\"name\":\"zhangsan\",\"age\":100}, {\"name\":\"wangwu\",\"age\":90}, {\"name\":\"xiaozhang\",\"age\":20} ]}"; &nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Document document; &nbsp;&nbsp;&nbsp;&nbsp;document.Parse(str.c_str()); &nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Value&amp; names_json = document["names"]; &nbsp;&nbsp;&nbsp;&nbsp;for (rapidjson::Value::ValueIterator iter=names_json.Begin(); iter!=names_json.End();) &nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;std::string name = (*iter)["name"].GetString(); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// 不要小张了 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if (name == "xiaozhang") &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;iter = names_json.Erase(iter); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;else &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;++iter; &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::StringBuffer buffer; &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Writer&lt;rapidjson::StringBuffer&gt; writer(buffer); &nbsp;&nbsp;&nbsp;&nbsp;document.Accept(writer); &nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;printf("%s\n", str.c_str()); &nbsp;&nbsp;&nbsp;&nbsp;printf("%s\n", buffer.GetString()); } </td> 
 </tr> 
 </tbody> 
</table>

1.   **示例10：不转义中文**

1.  运行输出结果

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> {"title":"贫困孤儿助养"} {"title":"\u8D2B\u56F0\u5B64\u513F\u52A9\u517B"} </td> 
 </tr> 
 </tbody> 
</table>

1.  示例代码

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> //g++ -g -o b b.cpp -I/usr/local/thirdparty/rapidjson/include #include &lt;rapidjson/document.h&gt; #include &lt;rapidjson/stringbuffer.h&gt; #include &lt;rapidjson/writer.h&gt; #include &lt;string&gt; #include &lt;stdio.h&gt; int main() { &nbsp;&nbsp;&nbsp;&nbsp;std::string str = "{\"title\":\"\u8d2b\u56f0\u5b64\u513f\u52a9\u517b\"}"; &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Document document; &nbsp;&nbsp;&nbsp;&nbsp;document.Parse(str.c_str()); &nbsp;&nbsp;&nbsp;&nbsp;if (document.HasParseError()) &nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;printf("parse %s failed\n", str.c_str()); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;exit(1); &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::StringBuffer buffer1; &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Writer&lt;rapidjson::StringBuffer&gt; writer1(buffer1); &nbsp;&nbsp;&nbsp;&nbsp;document.Accept(writer1); &nbsp;&nbsp;&nbsp;&nbsp;printf("%s\n", buffer1.GetString()); &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::StringBuffer buffer2; &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Writer&lt;rapidjson::StringBuffer, rapidjson::Document::EncodingType, rapidjson::ASCII&lt;&gt; &gt; writer2(buffer2); &nbsp;&nbsp;&nbsp;&nbsp;document.Accept(writer2); &nbsp;&nbsp;&nbsp;&nbsp;printf("%s\n", buffer2.GetString()); &nbsp;&nbsp;&nbsp;&nbsp;return 0; } </td> 
 </tr> 
 </tbody> 
</table>

1.   **示例11：schema使用示例**

json的schema用来检验json数据，它也采用了json格式。

1.  示例代码

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> rapidjson::Document schema_document; schema_document.Parse(schema.c_str()); if (!schema_document.HasParseError()) { &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Document document; &nbsp;&nbsp;&nbsp;&nbsp;document.Parse(str.c_str()); &nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;if (!document.HasParseError()) &nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;SchemaDocument schema(schema_document); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;SchemaValidator validator(schema); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if (!document.Accept(validator)) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// 检验出错，输出错误信息 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;StringBuffer sb; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;validator.GetInvalidSchemaPointer().StringifyUriFragment(sb); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;printf("Invalid schema: %s\n", sb.GetString()); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;printf("Invalid keyword: %s\n", validator.GetInvalidSchemaKeyword()); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;sb.Clear(); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;validator.GetInvalidDocumentPointer().StringifyUriFragment(sb); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;printf("Invalid document: %s\n", sb.GetString()); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;} } </td> 
 </tr> 
 </tbody> 
</table>

1.  示例json

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> { &nbsp;&nbsp;&nbsp;&nbsp;"id": 1, &nbsp;&nbsp;&nbsp;&nbsp;"name": "A green door", &nbsp;&nbsp;&nbsp;&nbsp;"price": 12.50, &nbsp;&nbsp;&nbsp;&nbsp;"tags": ["home", "green"] } </td> 
 </tr> 
 </tbody> 
</table>

1.  上段json对应的schema

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> { &nbsp;&nbsp;&nbsp;&nbsp;"$schema": "http://json-schema.org/draft-04/schema#", &nbsp;&nbsp;&nbsp;&nbsp;"title": "Product", &nbsp;&nbsp;&nbsp;&nbsp;"description": "A product from Acme's catalog", &nbsp;&nbsp;&nbsp;&nbsp;"type": "object", &nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;"properties": { &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"id": { &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"description": "The unique identifier for a product", &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"type": "integer" &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"name": { &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"description": "Name of the product", &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"type": "string" &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"price": { &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"type": "number", &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"minimum": 0, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"exclusiveMinimum": true &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"tags": { &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"type": "array", &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"items": { &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"type": "string" &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"minItems": 1, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"uniqueItems": true &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;"required": ["id", "name", "price"] } </td> 
 </tr> 
 </tbody> 
</table>

“title”和“description”是描述性的，可以不写。$schema也是可选的，依据的是《JSON Schema Draft v4》。

1.   **示例12：schema完整示例**

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> #include &lt;rapidjson/document.h&gt; #include &lt;rapidjson/schema.h&gt; #include &lt;rapidjson/stringbuffer.h&gt; int main() { &nbsp;&nbsp;&nbsp;&nbsp;std::string str = "\{\"aaa\":111,\"aaa\":222}"; // "\{\"aaa\":111,\"a\":222}" #if 0 &nbsp;&nbsp;&nbsp;&nbsp;std::string schema_str = "{\"type\":\"object\",\"properties\":{\"aaa\":{\"type\":\"integer\"},\"bbb\":{\"type\":\"string\"}},\"required\":[\"aaa\",\"bbb\"]}"; #else &nbsp;&nbsp;&nbsp;&nbsp;std::string schema_str = "{\"type\":\"object\",\"properties\":{\"aaa\":{\"type\":\"integer\"},\"bbb\":{\"type\":\"integer\"}},\"required\":[\"aaa\",\"bbb\"]}"; #endif &nbsp;&nbsp;&nbsp;&nbsp;printf("%s\n", str.c_str()); &nbsp;&nbsp;&nbsp;&nbsp;printf("%s\n", schema_str.c_str()); &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Document doc; &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Document schema_doc; &nbsp;&nbsp;&nbsp;&nbsp;schema_doc.Parse(schema_str.c_str()); &nbsp;&nbsp;&nbsp;&nbsp;doc.Parse(str.c_str()); &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::SchemaDocument schema(schema_doc); &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::SchemaValidator validator(schema); &nbsp;&nbsp;&nbsp;&nbsp;if (doc.Accept(validator)) &nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;printf("data ok\n"); &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;else &nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;rapidjson::StringBuffer sb; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;validator.GetInvalidSchemaPointer().StringifyUriFragment(sb); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;printf("Invalid schema: %s\n", sb.GetString()); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;printf("Invalid keyword: %s\n", validator.GetInvalidSchemaKeyword()); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;sb.Clear(); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;validator.GetInvalidDocumentPointer().StringifyUriFragment(sb); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;printf("Invalid document: %s\n", sb.GetString()); &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;return 0; } </td> 
 </tr> 
 </tbody> 
</table>

1.   **FindMember整数值**

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> int age; const rapidjson::Value::ConstMemberIterator iter = &nbsp;&nbsp;&nbsp;&nbsp;doc.FindMember("age"); if (iter!=doc.MemberEnd() &amp;&amp; iter-&gt;value.IsInt()) &nbsp;&nbsp;&nbsp;&nbsp;age = iter-&gt;value.GetInt(); </td> 
 </tr> 
 </tbody> 
</table>

1.   **FindMember字符串值**

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> std::string name; const rapidjson::Value::ConstMemberIterator iter = &nbsp;&nbsp;&nbsp;&nbsp;doc.FindMember("name"); if (iter!=doc.MemberEnd() &amp;&amp; iter-&gt;value.IsString()) &nbsp;&nbsp;&nbsp;&nbsp;name.assign(iter-&gt;value.GetString(), iter-&gt;value.GetStringLength()); </td> 
 </tr> 
 </tbody> 
</table>

1.   **遍历成员**

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> rapidjson::Value value; 。。。 for (rapidjson::Value::ConstMemberIterator iter=value.MemberBegin(); &nbsp;&nbsp;&nbsp;&nbsp;iter!=value.MemberEnd(); ++iter) { &nbsp;&nbsp;&nbsp;&nbsp;const rapidjson::Value&amp; name_json = iter-&gt;name; // 这个必是字符串 &nbsp;&nbsp;&nbsp;&nbsp;const rapidjson::Value&amp; value_json = iter-&gt;value; // 这个可以为对象、数组等 &nbsp;&nbsp;&nbsp;&nbsp;printf("%s\n", name_json.GetString()); } </td> 
 </tr> 
 </tbody> 
</table>

1.   **遍历数组1：字符串数组**

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> // 示例数组： // {"k":["k1","k2","k3"]} rapidjson::Document doc; doc.Parse(str.c_str()); const rapidjson::Value&amp; k = doc["k"]; // 遍历数组 for (rapidjson::Value::ConstValueIterator v_iter=k.Begin(); &nbsp;&nbsp;&nbsp;&nbsp;v_iter!=k.End(); ++v_iter) { &nbsp;&nbsp;&nbsp;&nbsp;// k1 &nbsp;&nbsp;&nbsp;&nbsp;// k2 &nbsp;&nbsp;&nbsp;&nbsp;// k3 &nbsp;&nbsp;&nbsp;&nbsp;printf("%s\n", (*v_iter).GetString()); } </td> 
 </tr> 
 </tbody> 
</table>

1.   **遍历数组2：一级对象数组**

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> // 数组示例： // {"h":[{"k1":"f1"},{"k2":"f2"}]} rapidjson::Document doc; doc.Parse(str.c_str()); const rapidjson::Value&amp; h = doc["h"]; // 遍历数组 for (rapidjson::Value::ConstValueIterator v_iter=h.Begin(); &nbsp;&nbsp;&nbsp;&nbsp;v_iter!=h.End(); ++v_iter) { &nbsp;&nbsp;&nbsp;&nbsp;const rapidjson::Value&amp; field = *v_iter; &nbsp;&nbsp;&nbsp;&nbsp;for (rapidjson::Value::ConstMemberIterator m_iter=field.MemberBegin(); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;m_iter!=field.MemberEnd(); ++m_iter) // kf对 &nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// k1 =&gt; f1 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// k2 =&gt; f2 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;const char* key = m_iter-&gt;name.GetString(); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;const char* value = m_iter-&gt;value.GetString(); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;printf("%s =&gt; %s\n", key, value); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;break; &nbsp;&nbsp;&nbsp;&nbsp;} } </td> 
 </tr> 
 </tbody> 
</table>

1.   **遍历数组3：两级对象数组**

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> // 数组示例： // {"h":[{"k1":["f1","f2"]},{"k2":["f1","f2"]}]} rapidjson::Document doc; doc.Parse(str.c_str()); const rapidjson::Value&amp; h = doc["h"]; // 遍历第一级数组 for (rapidjson::Value::ConstValueIterator v1_iter=h.Begin(); &nbsp;&nbsp;&nbsp;&nbsp;v1_iter!=h.End(); ++v1_iter) { &nbsp;&nbsp;&nbsp;&nbsp;const rapidjson::Value&amp; k = *v1_iter; // k1,k2,k3 &nbsp;&nbsp;&nbsp;&nbsp;// 成员遍历 &nbsp;&nbsp;&nbsp;&nbsp;for (rapidjson::Value::ConstMemberIterator m_iter=k.MemberBegin(); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;m_iter!=k.MemberEnd(); ++m_iter) &nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;const char* node_name = m_iter-&gt;name.GetString(); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;printf("hk: %s\n", node_name); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;const rapidjson::Value&amp; node = m_iter-&gt;value; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// 遍历第二级数组 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;for (rapidjson::Value::ConstValueIterator v2_iter=node.Begin(); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;v2_iter!=node.End(); ++v2_iter) &nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;const char* field = (*v2_iter).GetString(); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;printf("field: %s\n", field); // f1,f2,f3 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;} } </td> 
 </tr> 
 </tbody> 
</table>

1.   **辅助函数1：任意类型都以字符串返回**

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> // 如果不存在，或者为数组则返回空字符串。 std::string rapidjson_string_value(rapidjson::Value&amp; value, const std::string&amp; name) { &nbsp;&nbsp;&nbsp;&nbsp;if (!value.HasMember(name.c_str())) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return std::string(""); &nbsp;&nbsp;&nbsp;&nbsp;const rapidjson::Value&amp; child = value[name.c_str()]; &nbsp;&nbsp;&nbsp;&nbsp;if (child.IsString()) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return child.GetString(); &nbsp;&nbsp;&nbsp;&nbsp;char str[100]; &nbsp;&nbsp;&nbsp;&nbsp;if (child.IsInt()) &nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;snprintf(str, sizeof(str), "%d", child.GetInt()); &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;else if (child.IsInt64()) &nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// 为使用PRId64，需要#include &lt;inttypes.h&gt;， &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// 同时编译时需要定义宏__STDC_FORMAT_MACROS &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;snprintf(str, sizeof(str), "%"PRId64, child.GetInt64()); &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;else if (child.IsUint()) &nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;snprintf(str, sizeof(str), "%u", child.GetUint()); &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;else if (child.IsUint64()) &nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;snprintf(str, sizeof(str), "%"PRIu64, child.GetUint64()); &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;else if (child.IsDouble()) &nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;snprintf(str, sizeof(str), "%.2lf", child.GetDouble()); &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;else if (child.IsBool()) &nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if (child.IsTrue()) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;strcpy(str, "true"); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;else &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;strcpy(str, "false"); &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;else &nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;str[0] = '\0'; &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;return str; } </td> 
 </tr> 
 </tbody> 
</table>

1.   **辅助函数2：取int32\_t值**

当为int32\_t值或字符串实际为int32\_t值时，返回对应的int32\_t值，其它情况返回0。

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> // 当为int32_t值，或字符串实际为int32_t值时，返回对应的int32_t值，其它情况返回0 int32_t rapidjson_int32_value(rapidjson::Value&amp; value, const std::string&amp; name) { &nbsp;&nbsp;&nbsp;&nbsp;if (!value.HasMember(name.c_str())) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return 0; &nbsp;&nbsp;&nbsp;&nbsp;const rapidjson::Value&amp; child = value[name.c_str()]; &nbsp;&nbsp;&nbsp;&nbsp;if (child.IsInt()) &nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return child.GetInt(); &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;else if (child.IsString()) &nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return atoi(child.GetString()); &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;return 0; } </td> 
 </tr> 
 </tbody> 
</table>

1.   **辅助函数3：取int64\_t值**

当为int64\_t值，或字符串实际为int64\_t值时，返回对应的int64\_t值，其它情况返回0。

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> int64_t rapidjson_int64_value(rapidjson::Value&amp; value, const std::string&amp; name) { &nbsp;&nbsp;&nbsp;&nbsp;if (!value.HasMember(name.c_str())) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return 0; &nbsp;&nbsp;&nbsp;&nbsp;const rapidjson::Value&amp; child = value[name.c_str()]; &nbsp;&nbsp;&nbsp;&nbsp;if (child.IsInt64()) &nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return child.GetInt64(); &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;else if (child.IsString()) &nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return (int64_t)atoll(child.GetString()); &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;return 0; } </td> 
 </tr> 
 </tbody> 
</table>

1.   **辅助函数4：取uint32\_t值**

当为uin32\_t值，或字符串实际为uin32\_t值时，返回对应的uin32\_t值，其它情况返回0。

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> uint32_t rapidjson_uint32_value(rapidjson::Value&amp; value, const std::string&amp; name) { &nbsp;&nbsp;&nbsp;&nbsp;if (!value.HasMember(name.c_str())) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return 0; &nbsp;&nbsp;&nbsp;&nbsp;const rapidjson::Value&amp; child = value[name.c_str()]; &nbsp;&nbsp;&nbsp;&nbsp;if (child.IsUint()) &nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return child.GetUint(); &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;else if (child.IsString()) &nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return (uint32_t)atoll(child.GetString()); &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;return 0; } </td> 
 </tr> 
 </tbody> 
</table>

1.   **辅助函数5：取uint64\_t值**

当为uin64\_t值，或字符串实际为uin64\_t值时，返回对应的uin64\_t值，其它情况返回0。

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> uint64_t rapidjson_uint64_value(rapidjson::Value&amp; value, const std::string&amp; name) { &nbsp;&nbsp;&nbsp;&nbsp;if (!value.HasMember(name.c_str())) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return 0; &nbsp;&nbsp;&nbsp;&nbsp;const rapidjson::Value&amp; child = value[name.c_str()]; &nbsp;&nbsp;&nbsp;&nbsp;if (child.IsUint64()) &nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return child.GetUint64(); &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;else if (child.IsString()) &nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return (uint64_t)atoll(child.GetString()); &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;return 0; } </td> 
 </tr> 
 </tbody> 
</table>

1.   **辅助函数6：对象转字符串**

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> std::string&amp; to_string(const rapidjson::Value&amp; value, std::string* str) { &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::StringBuffer buffer; &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Writer&lt;rapidjson::StringBuffer&gt; writer(buffer); &nbsp;&nbsp;&nbsp;&nbsp;value.Accept(writer); &nbsp;&nbsp;&nbsp;&nbsp;str-&gt;assign(buffer.GetString(), buffer.GetSize()); &nbsp;&nbsp;&nbsp;&nbsp;return *str; } std::string to_string(const rapidjson::Value&amp; value) { &nbsp;&nbsp;&nbsp;&nbsp;std::string str; &nbsp;&nbsp;&nbsp;&nbsp;to_string(value, &amp;str); #if __cplusplus &lt; 201103L &nbsp;&nbsp;&nbsp;&nbsp;return str; #else &nbsp;&nbsp;&nbsp;&nbsp;return std::move(str); #endif // __cplusplus &lt; 201103L } </td> 
 </tr> 
 </tbody> 
</table>

1.   **辅助函数7：字符串转对象**

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> bool to_rapidjson(const std::string&amp; str, rapidjson::Document* doc) { &nbsp;&nbsp;&nbsp;&nbsp;doc-&gt;Parse(str.c_str()); &nbsp;&nbsp;&nbsp;&nbsp;return !doc-&gt;HasParseError(); } void to_rapidjson(const std::string&amp; str, rapidjson::Document&amp; doc) { &nbsp;&nbsp;&nbsp;&nbsp;doc.Parse(str.c_str()); &nbsp;&nbsp;&nbsp;&nbsp;if (doc.HasParseError()) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;doc.Parse("{}"); } </td> 
 </tr> 
 </tbody> 
</table>

1.   **rapidjson的“坑”**

使用不当，则会掉进“坑”里。下列代码在valgrind中运行时，会报大量错误，而且如果sub是在一个循环中被AddMember，则无法得到预期的结果。

从现象看像是sub析构后仍在被使用，为验证这个推测，改成：rapidjson::Document\* sub = new rapidjson::Document;，然后再使用不但valgrind不报错，而且循环使用也没问题，那么可以肯定AddMember是浅拷贝，这样一来使用就不方便了，除非还有深拷贝的调用方式。

上述代码在valgrind中跑，会报错大量如下这样的错误：

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> ==30425== Invalid read of size 2 ==30425== &nbsp;&nbsp;&nbsp;at 0x804B008: rapidjson::GenericValue&lt;rapidjson::UTF8&lt;char&gt;, rapidjson::MemoryPoolAllocator&lt;rapidjson::CrtAllocator&gt; &gt;::IsString() const (document.h:947) ==30425== &nbsp;&nbsp;&nbsp;by 0x8051632: bool rapidjson::GenericValue&lt;rapidjson::UTF8&lt;char&gt;, rapidjson::MemoryPoolAllocator&lt;rapidjson::CrtAllocator&gt; &gt;::Accept&lt;rapidjson::Writer&lt;rapidjson::GenericStringBuffer&lt;rapidjson::UTF8&lt;char&gt;, rapidjson::CrtAllocator&gt;, rapidjson::UTF8&lt;char&gt;, rapidjson::UTF8&lt;char&gt;, rapidjson::CrtAllocator, 0u&gt; &gt;(rapidjson::Writer&lt;rapidjson::GenericStringBuffer&lt;rapidjson::UTF8&lt;char&gt;, rapidjson::CrtAllocator&gt;, rapidjson::UTF8&lt;char&gt;, rapidjson::UTF8&lt;char&gt;, rapidjson::CrtAllocator, 0u&gt;&amp;) const (document.h:1769) ==30425== &nbsp;&nbsp;&nbsp;by 0x80488CE: main (f.cpp:30) ==30425== &nbsp;Address 0x428eb62 is 58 bytes inside a block of size 65,548 free'd ==30425== &nbsp;&nbsp;&nbsp;at 0x4023329: free (vg_replace_malloc.c:473) ==30425== &nbsp;&nbsp;&nbsp;by 0x804BC72: rapidjson::CrtAllocator::Free(void*) (allocators.h:79) ==30425== &nbsp;&nbsp;&nbsp;by 0x804BDD7: rapidjson::MemoryPoolAllocator&lt;rapidjson::CrtAllocator&gt;::Clear() (allocators.h:148) ==30425== &nbsp;&nbsp;&nbsp;by 0x804BE2E: rapidjson::MemoryPoolAllocator&lt;rapidjson::CrtAllocator&gt;::~MemoryPoolAllocator() (allocators.h:140) ==30425== &nbsp;&nbsp;&nbsp;by 0x804BE5F: rapidjson::GenericDocument&lt;rapidjson::UTF8&lt;char&gt;, rapidjson::MemoryPoolAllocator&lt;rapidjson::CrtAllocator&gt;, rapidjson::CrtAllocator&gt;::Destroy() (document.h:2382) ==30425== &nbsp;&nbsp;&nbsp;by 0x804BE7E: rapidjson::GenericDocument&lt;rapidjson::UTF8&lt;char&gt;, rapidjson::MemoryPoolAllocator&lt;rapidjson::CrtAllocator&gt;, rapidjson::CrtAllocator&gt;::~GenericDocument() (document.h:2064) </td> 
 </tr> 
 </tbody> 
</table>

正确可以使用的写法：

<table style="width:426.1pt;"> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;width:426.1pt;"> #include &lt;rapidjson/schema.h&gt; #include &lt;rapidjson/document.h&gt; #include &lt;rapidjson/stringbuffer.h&gt; #include &lt;rapidjson/writer.h&gt; #include &lt;string&gt; #include &lt;vector&gt; int main() { &nbsp;&nbsp;&nbsp;&nbsp;std::vector&lt;rapidjson::Document*&gt; subs; &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Document doc; &nbsp;&nbsp;&nbsp;&nbsp;doc.Parse("{}"); &nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// 注意，下面没有使用Document的默认构造， &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// 而是指定Allocator为其父的Allocator。 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// 如果存在多级Document，一定要统一使用根Document的Allocator， &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// 原因是Allocator分配的内存会随Document析构被释放掉！ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// 如果不这样做，必须保证sub的生命在doc之后才结束。 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Document sub(&amp;doc.GetAllocator()); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;sub.Parse("{\"name\":\"tom\"}"); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;doc.AddMember("sub", sub, doc.GetAllocator()); &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::StringBuffer buffer; &nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Writer&lt;rapidjson::StringBuffer&gt; writer(buffer); &nbsp;&nbsp;&nbsp;&nbsp;doc.Accept(writer); &nbsp;&nbsp;&nbsp;&nbsp;printf("%s\n", buffer.GetString()); &nbsp;&nbsp;&nbsp;&nbsp;for (std::vector&lt;rapidjson::Document*&gt;::size_type i=0; i&lt;subs.size(); ++i) &nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;rapidjson::Document *sub_ptr = subs[i]; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;delete sub_ptr; &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;subs.clear(); &nbsp;&nbsp;&nbsp;&nbsp;return 0; } </td> 
 </tr> 
 </tbody> 
</table>

[RapidJSON_]: http://rapidjson.org/zh-cn/
[RapidJSON_ 1]: http://rapidjson.org/zh-cn/md_doc_tutorial_8zh-cn.html#MoveSemantics
[https_github.com_Tencent_rapidjson_issues_1333]: https://github.com/Tencent/rapidjson/issues/1333