Initial version (0.1)

git-svn-id: https://rapidjson.googlecode.com/svn/trunk@2 c5894555-1306-4e8d-425f-1f6f381ee07c

bin/data/glossary.json

+{
+    "glossary": {
+        "title": "example glossary",
+		"GlossDiv": {
+            "title": "S",
+			"GlossList": {
+                "GlossEntry": {
+                    "ID": "SGML",
+					"SortAs": "SGML",
+					"GlossTerm": "Standard Generalized Markup Language",
+					"Acronym": "SGML",
+					"Abbrev": "ISO 8879:1986",
+					"GlossDef": {
+                        "para": "A meta-markup language, used to create markup languages such as DocBook.",
+						"GlossSeeAlso": ["GML", "XML"]
+                    },
+					"GlossSee": "markup"
+                }
+            }
+        }
+    }
+}
\ No newline at end of file

bin/data/menu.json

+{"menu": {
+    "header": "SVG Viewer",
+    "items": [
+        {"id": "Open"},
+        {"id": "OpenNew", "label": "Open New"},
+        null,
+        {"id": "ZoomIn", "label": "Zoom In"},
+        {"id": "ZoomOut", "label": "Zoom Out"},
+        {"id": "OriginalView", "label": "Original View"},
+        null,
+        {"id": "Quality"},
+        {"id": "Pause"},
+        {"id": "Mute"},
+        null,
+        {"id": "Find", "label": "Find..."},
+        {"id": "FindAgain", "label": "Find Again"},
+        {"id": "Copy"},
+        {"id": "CopyAgain", "label": "Copy Again"},
+        {"id": "CopySVG", "label": "Copy SVG"},
+        {"id": "ViewSVG", "label": "View SVG"},
+        {"id": "ViewSource", "label": "View Source"},
+        {"id": "SaveAs", "label": "Save As"},
+        null,
+        {"id": "Help"},
+        {"id": "About", "label": "About Adobe CVG Viewer..."}
+    ]
+}}
\ No newline at end of file

bin/data/readme.txt

+sample.json is obtained from http://code.google.com/p/json-test-suite/downloads/detail?name=sample.zip

bin/data/webapp.json

+{"web-app": {
+  "servlet": [   
+    {
+      "servlet-name": "cofaxCDS",
+      "servlet-class": "org.cofax.cds.CDSServlet",
+      "init-param": {
+        "configGlossary:installationAt": "Philadelphia, PA",
+        "configGlossary:adminEmail": "ksm@pobox.com",
+        "configGlossary:poweredBy": "Cofax",
+        "configGlossary:poweredByIcon": "/images/cofax.gif",
+        "configGlossary:staticPath": "/content/static",
+        "templateProcessorClass": "org.cofax.WysiwygTemplate",
+        "templateLoaderClass": "org.cofax.FilesTemplateLoader",
+        "templatePath": "templates",
+        "templateOverridePath": "",
+        "defaultListTemplate": "listTemplate.htm",
+        "defaultFileTemplate": "articleTemplate.htm",
+        "useJSP": false,
+        "jspListTemplate": "listTemplate.jsp",
+        "jspFileTemplate": "articleTemplate.jsp",
+        "cachePackageTagsTrack": 200,
+        "cachePackageTagsStore": 200,
+        "cachePackageTagsRefresh": 60,
+        "cacheTemplatesTrack": 100,
+        "cacheTemplatesStore": 50,
+        "cacheTemplatesRefresh": 15,
+        "cachePagesTrack": 200,
+        "cachePagesStore": 100,
+        "cachePagesRefresh": 10,
+        "cachePagesDirtyRead": 10,
+        "searchEngineListTemplate": "forSearchEnginesList.htm",
+        "searchEngineFileTemplate": "forSearchEngines.htm",
+        "searchEngineRobotsDb": "WEB-INF/robots.db",
+        "useDataStore": true,
+        "dataStoreClass": "org.cofax.SqlDataStore",
+        "redirectionClass": "org.cofax.SqlRedirection",
+        "dataStoreName": "cofax",
+        "dataStoreDriver": "com.microsoft.jdbc.sqlserver.SQLServerDriver",
+        "dataStoreUrl": "jdbc:microsoft:sqlserver://LOCALHOST:1433;DatabaseName=goon",
+        "dataStoreUser": "sa",
+        "dataStorePassword": "dataStoreTestQuery",
+        "dataStoreTestQuery": "SET NOCOUNT ON;select test='test';",
+        "dataStoreLogFile": "/usr/local/tomcat/logs/datastore.log",
+        "dataStoreInitConns": 10,
+        "dataStoreMaxConns": 100,
+        "dataStoreConnUsageLimit": 100,
+        "dataStoreLogLevel": "debug",
+        "maxUrlLength": 500}},
+    {
+      "servlet-name": "cofaxEmail",
+      "servlet-class": "org.cofax.cds.EmailServlet",
+      "init-param": {
+      "mailHost": "mail1",
+      "mailHostOverride": "mail2"}},
+    {
+      "servlet-name": "cofaxAdmin",
+      "servlet-class": "org.cofax.cds.AdminServlet"},
+ 
+    {
+      "servlet-name": "fileServlet",
+      "servlet-class": "org.cofax.cds.FileServlet"},
+    {
+      "servlet-name": "cofaxTools",
+      "servlet-class": "org.cofax.cms.CofaxToolsServlet",
+      "init-param": {
+        "templatePath": "toolstemplates/",
+        "log": 1,
+        "logLocation": "/usr/local/tomcat/logs/CofaxTools.log",
+        "logMaxSize": "",
+        "dataLog": 1,
+        "dataLogLocation": "/usr/local/tomcat/logs/dataLog.log",
+        "dataLogMaxSize": "",
+        "removePageCache": "/content/admin/remove?cache=pages&id=",
+        "removeTemplateCache": "/content/admin/remove?cache=templates&id=",
+        "fileTransferFolder": "/usr/local/tomcat/webapps/content/fileTransferFolder",
+        "lookInContext": 1,
+        "adminGroupID": 4,
+        "betaServer": true}}],
+  "servlet-mapping": {
+    "cofaxCDS": "/",
+    "cofaxEmail": "/cofaxutil/aemail/*",
+    "cofaxAdmin": "/admin/*",
+    "fileServlet": "/static/*",
+    "cofaxTools": "/tools/*"},
+ 
+  "taglib": {
+    "taglib-uri": "cofax.tld",
+    "taglib-location": "/WEB-INF/tlds/cofax.tld"}}}
\ No newline at end of file

bin/data/widget.json

+{"widget": {
+    "debug": "on",
+    "window": {
+        "title": "Sample Konfabulator Widget",
+        "name": "main_window",
+        "width": 500,
+        "height": 500
+    },
+    "image": { 
+        "src": "Images/Sun.png",
+        "name": "sun1",
+        "hOffset": 250,
+        "vOffset": 250,
+        "alignment": "center"
+    },
+    "text": {
+        "data": "Click Here",
+        "size": 36,
+        "style": "bold",
+        "name": "text1",
+        "hOffset": 250,
+        "vOffset": 100,
+        "alignment": "center",
+        "onMouseUp": "sun1.opacity = (sun1.opacity / 100) * 90;"
+    }
+}}
\ No newline at end of file

bin/jsonchecker/fail1.json

+"A JSON payload should be an object or array, not a string."
\ No newline at end of file

bin/jsonchecker/fail10.json

+{"Extra value after close": true} "misplaced quoted value"
\ No newline at end of file

bin/jsonchecker/fail11.json

+{"Illegal expression": 1 + 2}
\ No newline at end of file

bin/jsonchecker/fail12.json

+{"Illegal invocation": alert()}
\ No newline at end of file

bin/jsonchecker/fail13.json

+{"Numbers cannot have leading zeroes": 013}
\ No newline at end of file

bin/jsonchecker/fail14.json

+{"Numbers cannot be hex": 0x14}
\ No newline at end of file

bin/jsonchecker/fail15.json

+["Illegal backslash escape: \x15"]
\ No newline at end of file

bin/jsonchecker/fail16.json

+[\naked]
\ No newline at end of file

bin/jsonchecker/fail17.json

+["Illegal backslash escape: \017"]
\ No newline at end of file

bin/jsonchecker/fail18.json

+[[[[[[[[[[[[[[[[[[[["Too deep"]]]]]]]]]]]]]]]]]]]]
\ No newline at end of file

bin/jsonchecker/fail19.json

+{"Missing colon" null}
\ No newline at end of file

bin/jsonchecker/fail2.json

+["Unclosed array"
\ No newline at end of file

bin/jsonchecker/fail20.json

+{"Double colon":: null}
\ No newline at end of file

bin/jsonchecker/fail21.json

+{"Comma instead of colon", null}
\ No newline at end of file

bin/jsonchecker/fail22.json

+["Colon instead of comma": false]
\ No newline at end of file

bin/jsonchecker/fail23.json

+["Bad value", truth]
\ No newline at end of file

bin/jsonchecker/fail24.json

+['single quote']
\ No newline at end of file

bin/jsonchecker/fail25.json

+["	tab	character	in	string	"]
\ No newline at end of file

bin/jsonchecker/fail26.json

+["tab\   character\   in\  string\  "]
\ No newline at end of file

bin/jsonchecker/fail27.json

+["line
+break"]
\ No newline at end of file

bin/jsonchecker/fail28.json

+["line\
+break"]
\ No newline at end of file

bin/jsonchecker/fail29.json

+[0e]
\ No newline at end of file

bin/jsonchecker/fail3.json

+{unquoted_key: "keys must be quoted"}
\ No newline at end of file

bin/jsonchecker/fail30.json

+[0e+]
\ No newline at end of file

bin/jsonchecker/fail31.json

+[0e+-1]
\ No newline at end of file

bin/jsonchecker/fail32.json

+{"Comma instead if closing brace": true,
\ No newline at end of file

bin/jsonchecker/fail33.json

+["mismatch"}
\ No newline at end of file

bin/jsonchecker/fail4.json

+["extra comma",]
\ No newline at end of file

bin/jsonchecker/fail5.json

+["double extra comma",,]
\ No newline at end of file

bin/jsonchecker/fail6.json

+[   , "<-- missing value"]
\ No newline at end of file

bin/jsonchecker/fail7.json

+["Comma after the close"],
\ No newline at end of file

bin/jsonchecker/fail8.json

+["Extra close"]]
\ No newline at end of file

bin/jsonchecker/fail9.json

+{"Extra comma": true,}
\ No newline at end of file

bin/jsonchecker/pass1.json

+[
+    "JSON Test Pattern pass1",
+    {"object with 1 member":["array with 1 element"]},
+    {},
+    [],
+    -42,
+    true,
+    false,
+    null,
+    {
+        "integer": 1234567890,
+        "real": -9876.543210,
+        "e": 0.123456789e-12,
+        "E": 1.234567890E+34,
+        "":  23456789012E66,
+        "zero": 0,
+        "one": 1,
+        "space": " ",
+        "quote": "\"",
+        "backslash": "\\",
+        "controls": "\b\f\n\r\t",
+        "slash": "/ & \/",
+        "alpha": "abcdefghijklmnopqrstuvwyz",
+        "ALPHA": "ABCDEFGHIJKLMNOPQRSTUVWYZ",
+        "digit": "0123456789",
+        "0123456789": "digit",
+        "special": "`1~!@#$%^&*()_+-={':[,]}|;.</>?",
+        "hex": "\u0123\u4567\u89AB\uCDEF\uabcd\uef4A",
+        "true": true,
+        "false": false,
+        "null": null,
+        "array":[  ],
+        "object":{  },
+        "address": "50 St. James Street",
+        "url": "http://www.JSON.org/",
+        "comment": "// /* <!-- --",
+        "# -- --> */": " ",
+        " s p a c e d " :[1,2 , 3
+
+,
+
+4 , 5        ,          6           ,7        ],"compact":[1,2,3,4,5,6,7],
+        "jsontext": "{\"object with 1 member\":[\"array with 1 element\"]}",
+        "quotes": "&#34; \u0022 %22 0x22 034 &#x22;",
+        "\/\\\"\uCAFE\uBABE\uAB98\uFCDE\ubcda\uef4A\b\f\n\r\t`1~!@#$%^&*()_+-=[]{}|;:',./<>?"
+: "A key can be any string"
+    },
+    0.5 ,98.6
+,
+99.44
+,
+
+1066,
+1e1,
+0.1e1,
+1e-1,
+1e00,2e+00,2e-00
+,"rosebud"]
\ No newline at end of file

bin/jsonchecker/pass2.json

+[[[[[[[[[[[[[[[[[[["Not too deep"]]]]]]]]]]]]]]]]]]]
\ No newline at end of file

bin/jsonchecker/pass3.json

+{
+    "JSON Test Pattern pass3": {
+        "The outermost value": "must be an object or array.",
+        "In this test": "It is an object."
+    }
+}

bin/jsonchecker/readme.txt

+Test suite from http://json.org/JSON_checker/.
+
+If the JSON_checker is working correctly, it must accept all of the pass*.json files and reject all of the fail*.json files.

build/premake

+premake4 vs2005
+premake4 vs2008
+premake4 vs2010
+premake4 gmake
\ No newline at end of file

build/premake.bat

+@echo off
+premake4 vs2005
+premake4 vs2008
+premake4 vs2010
+premake4 gmake
\ No newline at end of file

build/premake4.lua

+function setTargetObjDir(outDir)
+	for _, cfg in ipairs(configurations()) do
+		for _, plat in ipairs(platforms()) do
+			local action = _ACTION or ""
+			
+			local prj = project()
+			
+			--"_debug_win32_vs2008"
+			local suffix = "_" .. cfg .. "_" .. plat .. "_" .. action
+			
+			targetPath = outDir
+			
+			suffix = string.lower(suffix)
+
+			local obj_path = "../intermediate/" .. cfg .. "/" .. action .. "/" .. prj.name
+			
+			obj_path = string.lower(obj_path)
+			
+			configuration {cfg, plat}
+				targetdir(targetPath)
+				objdir(obj_path)
+				targetsuffix(suffix)
+		end
+	end
+end
+
+function linkLib(libBaseName)
+	for _, cfg in ipairs(configurations()) do
+		for _, plat in ipairs(platforms()) do
+			local action = _ACTION or ""
+			
+			local prj = project()
+			
+			local cfgName = cfg
+			
+			--"_debug_win32_vs2008"
+			local suffix = "_" .. cfgName .. "_" .. plat .. "_" .. action
+			
+			libFullName = libBaseName .. string.lower(suffix)
+			
+			configuration {cfg, plat}
+				links(libFullName)
+		end
+	end
+end
+
+solution "test"
+	configurations { "debug", "release" }
+	platforms { "x32", "x64" }
+
+	location ("./" .. (_ACTION or ""))
+	language "C++"
+	
+	configuration "debug"
+		defines { "DEBUG" }
+		flags { "Symbols" }
+
+	configuration "release"
+		defines { "NDEBUG" }
+		flags { "Optimize" }
+
+	configuration "vs*"
+		defines { "_CRT_SECURE_NO_WARNINGS" }
+		
+	configuration "gmake"
+		buildoptions "-msse4.2"
+
+	project "gtest"
+		kind "StaticLib"
+		files { 
+			"../thirdparty/gtest/src/gtest-all.cc",
+			"../thirdparty/gtest/src/**.h",
+		}
+
+		includedirs {
+			"../thirdparty/gtest/",
+			"../thirdparty/gtest/include",
+		}
+
+		setTargetObjDir("../thirdparty/lib")
+
+	project "unittest"
+		kind "ConsoleApp"
+		
+		files { 
+			"../include/**.h",
+			"../test/unittest/**.cpp",
+			"../test/unittest/**.h",
+		}
+		
+		includedirs {
+			"../include/",
+			"../thirdparty/gtest/include/",
+		}
+
+		libdirs "../thirdparty/lib"
+
+		setTargetObjDir("../bin")
+
+		linkLib "gtest"
+		links "gtest"
+		
+	project "perftest"
+		kind "ConsoleApp"
+		
+		files { 
+			"../include/**.h",
+			"../test/perftest/**.cpp",
+			"../test/perftest/**.c",
+			"../test/perftest/**.h",
+		}
+		
+		includedirs {
+			"../include/",
+			"../thirdparty/gtest/include/",
+			"../thirdparty/",
+			"../thirdparty/jsoncpp/include/",
+			"../thirdparty/libjson/",
+			"../thirdparty/yajl/include/",
+		}
+
+		libdirs "../thirdparty/lib"
+
+		setTargetObjDir("../bin")
+
+		linkLib "gtest"
+		links "gtest"
+
+solution "example"
+	configurations { "debug", "release" }
+	platforms { "x32", "x64" }
+	location ("./" .. (_ACTION or ""))
+	language "C++"
+	includedirs "../include/"
+
+	configuration "debug"
+		defines { "DEBUG" }
+		flags { "Symbols" }
+
+	configuration "release"
+		defines { "NDEBUG" }
+		flags { "Optimize", "EnableSSE2" }
+
+	configuration "vs*"
+		defines { "_CRT_SECURE_NO_WARNINGS" }
+
+	project "condense"
+		kind "ConsoleApp"
+		files "../example/condense/*"
+		setTargetObjDir("../bin")
+
+	project "pretty"
+		kind "ConsoleApp"
+		files "../example/pretty/*"
+		setTargetObjDir("../bin")
+
+	project "tutorial"
+		kind "ConsoleApp"
+		files "../example/tutorial/*"
+		setTargetObjDir("../bin")
+
+	project "serialize"
+		kind "ConsoleApp"
+		files "../example/serialize/*"
+		setTargetObjDir("../bin")

example/condense/condense.cpp

+// JSON condenser exmaple
+
+// This example parses JSON text from stdin with validation, 
+// and re-output the JSON content to stdout without whitespace.
+
+#include "rapidjson/reader.h"
+#include "rapidjson/writer.h"
+#include "rapidjson/filestream.h"
+
+using namespace rapidjson;
+
+int main(int argc, char* argv[]) {
+	// Prepare JSON reader and input stream.
+	Reader reader;
+	FileStream is(stdin);
+
+	// Prepare JSON writer and output stream.
+	FileStream os(stdout);
+	Writer<FileStream> writer(os);
+
+	// JSON reader parse from the input stream and let writer generate the output.
+	if (!reader.Parse<0>(is, writer)) {
+		fprintf(stderr, "\nError(%u): %s\n", (unsigned)reader.GetErrorOffset(), reader.GetParseError());
+		return 1;
+	}
+
+	return 0;
+}

example/pretty/pretty.cpp

+// JSON pretty formatting example
+
+#include "rapidjson/reader.h"
+#include "rapidjson/prettywriter.h"
+#include "rapidjson/filestream.h"
+
+using namespace rapidjson;
+
+int main(int argc, char* argv[]) {
+	// Prepare reader and input stream.
+	Reader reader;
+	FileStream is(stdin);
+
+	// Prepare writer and output stream.
+	FileStream os(stdout);
+	PrettyWriter<FileStream> writer(os);
+
+	// JSON reader parse from the input stream and let writer generate the output.
+	if (!reader.Parse<0>(is, writer)) {
+		fprintf(stderr, "\nError(%u): %s\n", (unsigned)reader.GetErrorOffset(), reader.GetParseError());
+		return 1;
+	}
+
+	return 0;
+}

example/serialize/serialize.cpp

+// Serialize example
+// This example shows writing JSON string with writer directly.
+
+#include "rapidjson/prettywriter.h"	// for stringify JSON
+#include "rapidjson/filestream.h"	// wrapper of C stream for prettywriter as output
+#include <cstdio>
+#include <string>
+#include <vector>
+
+using namespace rapidjson;
+
+class Person {
+public:
+	Person(const std::string& name, unsigned age) : name_(name), age_(age) {}
+	virtual ~Person() {}
+
+protected:
+	template <typename Writer>
+	void Serialize(Writer& writer) const {
+		// This base class just write out name-value pairs, without wrapping within an object.
+		writer.String("name");
+		writer.String(name_.c_str(), (SizeType)name_.length());	// Suppling length of string is faster.
+
+		writer.String("age");
+		writer.Uint(age_);
+	}
+
+private:
+	std::string name_;
+	unsigned age_;
+};
+
+class Education {
+public:
+	Education(const std::string& school, double GPA) : school_(school), GPA_(GPA) {}
+
+	template <typename Writer>
+	void Serialize(Writer& writer) const {
+		writer.StartObject();
+		
+		writer.String("school");
+		writer.String(school_.c_str(), (SizeType)school_.length());
+
+		writer.String("GPA");
+		writer.Double(GPA_);
+
+		writer.EndObject();
+	}
+
+private:
+	std::string school_;
+	double GPA_;
+};
+
+class Dependent : public Person {
+public:
+	Dependent(const std::string& name, unsigned age, Education* education = 0) : Person(name, age), education_(education) {}
+	Dependent(const Dependent& rhs) : Person(rhs) { education_ = (rhs.education_ == 0) ? 0 : new Education(*rhs.education_); }
+	~Dependent() { delete education_; }
+
+	template <typename Writer>
+	void Serialize(Writer& writer) const {
+		writer.StartObject();
+
+		Person::Serialize(writer);
+
+		writer.String("education");
+		if (education_)
+			education_->Serialize(writer);
+		else
+			writer.Null();
+
+		writer.EndObject();
+	}
+
+private:
+	Education *education_;
+};
+
+class Employee : public Person {
+public:
+	Employee(const std::string& name, unsigned age, bool married) : Person(name, age), married_(married) {}
+
+	void AddDependent(const Dependent& dependent) {
+		dependents_.push_back(dependent);
+	}
+
+	template <typename Writer>
+	void Serialize(Writer& writer) const {
+		writer.StartObject();
+
+		Person::Serialize(writer);
+
+		writer.String("married");
+		writer.Bool(married_);
+
+		writer.String(("dependents"));
+		writer.StartArray();
+		for (std::vector<Dependent>::const_iterator dependentItr = dependents_.begin(); dependentItr != dependents_.end(); ++dependentItr)
+			dependentItr->Serialize(writer);
+		writer.EndArray();
+
+		writer.EndObject();
+	}
+
+private:
+	bool married_;
+	std::vector<Dependent> dependents_;
+};
+
+int main(int argc, char* argv[]) {
+	std::vector<Employee> employees;
+
+	employees.push_back(Employee("Milo YIP", 34, true));
+	employees.back().AddDependent(Dependent("Lua YIP", 3, new Education("Happy Kindergarten", 3.5)));
+	employees.back().AddDependent(Dependent("Mio YIP", 1));
+
+	employees.push_back(Employee("Percy TSE", 30, false));
+
+	FileStream s(stdout);
+	PrettyWriter<FileStream> writer(s);		// Can also use Writer for condensed formatting
+
+	writer.StartArray();
+	for (std::vector<Employee>::const_iterator employeeItr = employees.begin(); employeeItr != employees.end(); ++employeeItr)
+		employeeItr->Serialize(writer);
+	writer.EndArray();
+
+	return 0;
+}

example/tutorial/tutorial.cpp

+// Hello World example
+// This example shows basic usage of DOM-style API.
+
+#include "rapidjson/document.h"		// rapidjson's DOM-style API
+#include "rapidjson/prettywriter.h"	// for stringify JSON
+#include "rapidjson/filestream.h"	// wrapper of C stream for prettywriter as output
+#include <cstdio>
+
+using namespace rapidjson;
+
+int main(int argc, char* argv[]) {
+	////////////////////////////////////////////////////////////////////////////
+	// 1. Parse a JSON text string to a document.
+
+	const char json[] = " { \"hello\" : \"world\", \"t\" : true , \"f\" : false, \"n\": null, \"i\":123, \"pi\": 3.1416, \"a\":[1, 2, 3, 4] } ";
+	printf("Original JSON:\n %s\n", json);
+
+	Document document;	// Default template parameter uses UTF8 and MemoryPoolAllocator.
+
+#if 0
+	// "normal" parsing, decode strings to new buffers. Can use other input stream via ParseStream().
+	if (document.Parse<0>(json).HasParseError())
+		return 1;
+#else
+	// In-situ parsing, decode strings directly in the source string. Source must be string.
+	char buffer[sizeof(json)];
+	memcpy(buffer, json, sizeof(json));
+	if (document.ParseInsitu<0>(buffer).HasParseError())
+		return 1;
+#endif
+
+	printf("\nParsing to document succeeded.\n");
+
+	////////////////////////////////////////////////////////////////////////////
+	// 2. Access values in document. 
+
+	printf("\nAccess values in document:\n");
+	assert(document.IsObject());	// Document is a JSON value represents the root of DOM. Root can be either an object or array.
+
+	assert(document.HasMember("hello"));
+	assert(document["hello"].IsString());
+	printf("hello = %s\n", document["hello"].GetString());
+
+	assert(document["t"].IsBool());		// JSON true/false are bool. Can also uses more specific function IsTrue().
+	printf("t = %s\n", document["t"].GetBool() ? "true" : "false");
+
+	assert(document["f"].IsBool());
+	printf("f = %s\n", document["f"].GetBool() ? "true" : "false");
+
+	printf("n = %s\n", document["n"].IsNull() ? "null" : "?");
+
+	assert(document["i"].IsNumber());	// Number is a JSON type, but C++ needs more specific type.
+	assert(document["i"].IsInt());		// In this case, IsUint()/IsInt64()/IsUInt64() also return true.
+	printf("i = %d\n", document["i"].GetInt());	// Alternative (int)document["i"]
+
+	assert(document["pi"].IsNumber());
+	assert(document["pi"].IsDouble());
+	printf("pi = %g\n", document["pi"].GetDouble());
+
+	{
+		const Value& a = document["a"];	// Using a reference for consecutive access is handy and faster.
+		assert(a.IsArray());
+		for (SizeType i = 0; i < a.Size(); i++)	// rapidjson uses SizeType instead of size_t.
+			printf("a[%d] = %d\n", i, a[i].GetInt());
+		
+		// Note:
+		//int x = a[0].GetInt();					// Error: operator[ is ambiguous, as 0 also mean a null pointer of const char* type.
+		int y = a[SizeType(0)].GetInt();			// Cast to SizeType will work.
+		int z = a[0u].GetInt();						// This works too.
+	}
+
+	// 3. Modify values in document.
+
+	// Change i to a bigger number
+	{
+		uint64_t f20 = 1;	// compute factorial of 20
+		for (uint64_t j = 1; j <= 20; j++)
+			f20 *= j;
+		document["i"] = f20;	// Alternate form: document["i"].SetUint64(f20)
+		assert(!document["i"].IsInt());	// No longer can be cast as int or uint.
+	}
+
+	// Adding values to array.
+	{
+		Value& a = document["a"];	// This time we uses non-const reference.
+		Document::AllocatorType& allocator = document.GetAllocator();
+		for (int i = 5; i <= 10; i++)
+			a.PushBack(i, allocator);	// May look a bit strange, allocator is needed for potentially realloc. We normally uses the document's.
+
+		// Fluent API
+		a.PushBack("Lua", allocator).PushBack("Mio", allocator);
+	}
+
+	// Making string values.
+
+	// This version of SetString() just store the pointer to the string.
+	// So it is for literal and string that exists within value's life-cycle.
+	{
+		document["hello"] = "rapidjson";	// This will invoke strlen()
+		// Faster version:
+		// document["hello"].SetString("rapidjson", 9);
+	}
+
+	// This version of SetString() needs an allocator, which means it will allocate a new buffer and copy the the string into the buffer.
+	Value author;
+	{
+		char buffer[10];
+		int len = sprintf(buffer, "%s %s", "Milo", "Yip");	// synthetic example of dynamically created string.
+
+		author.SetString(buffer, len, document.GetAllocator());
+		// Shorter but slower version:
+		// document["hello"].SetString(buffer, document.GetAllocator());
+
+		// Constructor version: 
+		// Value author(buffer, len, document.GetAllocator());
+		// Value author(buffer, document.GetAllocator());
+		memset(buffer, 0, sizeof(buffer)); // For demonstration purpose.
+	}
+	// Variable 'buffer' is unusable now but 'author' has already made a copy.
+	document.AddMember("author", author, document.GetAllocator());
+
+	assert(author.IsNull());		// Move semantic for assignment. After this variable is assigned as a member, the variable becomes null.
+
+	////////////////////////////////////////////////////////////////////////////
+	// 4. Stringify JSON
+
+	printf("\nModified JSON with reformatting:\n");
+	FileStream f(stdout);
+	PrettyWriter<FileStream> writer(f);
+	document.Accept(writer);	// Accept() traverses the DOM and generates Handler events.
+
+	return 0;
+}

include/rapidjson/filestream.h

+#ifndef RAPIDJSON_FILESTREAM_H_
+#define RAPIDJSON_FILESTREAM_H_
+
+#include <cstdio>
+
+namespace rapidjson {
+
+//! Wrapper of C file stream for input or output.
+/*!
+	This simple wrapper does not check the validity of the stream.
+	\implements Stream
+*/
+class FileStream {
+public:
+	typedef char Ch;	//!< Character type. Only support char.
+
+	FileStream(FILE* fp) : fp_(fp), count_(0) { Read(); }
+	char Peek() const { return current_; }
+	char Take() { char c = current_; Read(); return c; }
+	size_t Tell() const { return count_; }
+	void Put(char c) { fputc(c, fp_); }
+
+	// Not implemented
+	char* PutBegin() { return 0; }
+	size_t PutEnd(char*) { return 0; }
+
+private:
+	void Read() {
+		RAPIDJSON_ASSERT(fp_ != 0);
+		int c = fgetc(fp_);
+		if (c != EOF) {
+			current_ = (char)c;
+			count_++;
+		}
+		else
+			current_ = '\0';
+	}
+
+	FILE* fp_;
+	char current_;
+	size_t count_;
+};
+
+} // namespace rapidjson
+
+#endif // RAPIDJSON_FILESTREAM_H_

include/rapidjson/internal/pow10.h

+#ifndef RAPIDJSON_POW10_
+#define RAPIDJSON_POW10_
+
+namespace rapidjson {
+namespace internal {
+
+//! Computes integer powers of 10 in double (10.0^n).
+/*! This function uses lookup table for fast and accurate results.
+	\param n positive/negative exponent. Must <= 308.
+	\return 10.0^n
+*/
+inline double Pow10(int n) {
+	static const double e[] = { // 1e-308...1e308: 617 * 8 bytes = 4936 bytes
+		1e-308,1e-307,1e-306,1e-305,1e-304,1e-303,1e-302,1e-301,1e-300,
+		1e-299,1e-298,1e-297,1e-296,1e-295,1e-294,1e-293,1e-292,1e-291,1e-290,1e-289,1e-288,1e-287,1e-286,1e-285,1e-284,1e-283,1e-282,1e-281,1e-280,
+		1e-279,1e-278,1e-277,1e-276,1e-275,1e-274,1e-273,1e-272,1e-271,1e-270,1e-269,1e-268,1e-267,1e-266,1e-265,1e-264,1e-263,1e-262,1e-261,1e-260,
+		1e-259,1e-258,1e-257,1e-256,1e-255,1e-254,1e-253,1e-252,1e-251,1e-250,1e-249,1e-248,1e-247,1e-246,1e-245,1e-244,1e-243,1e-242,1e-241,1e-240,
+		1e-239,1e-238,1e-237,1e-236,1e-235,1e-234,1e-233,1e-232,1e-231,1e-230,1e-229,1e-228,1e-227,1e-226,1e-225,1e-224,1e-223,1e-222,1e-221,1e-220,
+		1e-219,1e-218,1e-217,1e-216,1e-215,1e-214,1e-213,1e-212,1e-211,1e-210,1e-209,1e-208,1e-207,1e-206,1e-205,1e-204,1e-203,1e-202,1e-201,1e-200,
+		1e-199,1e-198,1e-197,1e-196,1e-195,1e-194,1e-193,1e-192,1e-191,1e-190,1e-189,1e-188,1e-187,1e-186,1e-185,1e-184,1e-183,1e-182,1e-181,1e-180,
+		1e-179,1e-178,1e-177,1e-176,1e-175,1e-174,1e-173,1e-172,1e-171,1e-170,1e-169,1e-168,1e-167,1e-166,1e-165,1e-164,1e-163,1e-162,1e-161,1e-160,
+		1e-159,1e-158,1e-157,1e-156,1e-155,1e-154,1e-153,1e-152,1e-151,1e-150,1e-149,1e-148,1e-147,1e-146,1e-145,1e-144,1e-143,1e-142,1e-141,1e-140,
+		1e-139,1e-138,1e-137,1e-136,1e-135,1e-134,1e-133,1e-132,1e-131,1e-130,1e-129,1e-128,1e-127,1e-126,1e-125,1e-124,1e-123,1e-122,1e-121,1e-120,
+		1e-119,1e-118,1e-117,1e-116,1e-115,1e-114,1e-113,1e-112,1e-111,1e-110,1e-109,1e-108,1e-107,1e-106,1e-105,1e-104,1e-103,1e-102,1e-101,1e-100,
+		1e-99, 1e-98, 1e-97, 1e-96, 1e-95, 1e-94, 1e-93, 1e-92, 1e-91, 1e-90, 1e-89, 1e-88, 1e-87, 1e-86, 1e-85, 1e-84, 1e-83, 1e-82, 1e-81, 1e-80, 
+		1e-79, 1e-78, 1e-77, 1e-76, 1e-75, 1e-74, 1e-73, 1e-72, 1e-71, 1e-70, 1e-69, 1e-68, 1e-67, 1e-66, 1e-65, 1e-64, 1e-63, 1e-62, 1e-61, 1e-60, 
+		1e-59, 1e-58, 1e-57, 1e-56, 1e-55, 1e-54, 1e-53, 1e-52, 1e-51, 1e-50, 1e-49, 1e-48, 1e-47, 1e-46, 1e-45, 1e-44, 1e-43, 1e-42, 1e-41, 1e-40, 
+		1e-39, 1e-38, 1e-37, 1e-36, 1e-35, 1e-34, 1e-33, 1e-32, 1e-31, 1e-30, 1e-29, 1e-28, 1e-27, 1e-26, 1e-25, 1e-24, 1e-23, 1e-22, 1e-21, 1e-20, 
+		1e-19, 1e-18, 1e-17, 1e-16, 1e-15, 1e-14, 1e-13, 1e-12, 1e-11, 1e-10, 1e-9,  1e-8,  1e-7,  1e-6,  1e-5,  1e-4,  1e-3,  1e-2,  1e-1,  1e+0,  
+		1e+1,  1e+2,  1e+3,  1e+4,  1e+5,  1e+6,  1e+7,  1e+8,  1e+9,  1e+10, 1e+11, 1e+12, 1e+13, 1e+14, 1e+15, 1e+16, 1e+17, 1e+18, 1e+19, 1e+20, 
+		1e+21, 1e+22, 1e+23, 1e+24, 1e+25, 1e+26, 1e+27, 1e+28, 1e+29, 1e+30, 1e+31, 1e+32, 1e+33, 1e+34, 1e+35, 1e+36, 1e+37, 1e+38, 1e+39, 1e+40,
+		1e+41, 1e+42, 1e+43, 1e+44, 1e+45, 1e+46, 1e+47, 1e+48, 1e+49, 1e+50, 1e+51, 1e+52, 1e+53, 1e+54, 1e+55, 1e+56, 1e+57, 1e+58, 1e+59, 1e+60,
+		1e+61, 1e+62, 1e+63, 1e+64, 1e+65, 1e+66, 1e+67, 1e+68, 1e+69, 1e+70, 1e+71, 1e+72, 1e+73, 1e+74, 1e+75, 1e+76, 1e+77, 1e+78, 1e+79, 1e+80,
+		1e+81, 1e+82, 1e+83, 1e+84, 1e+85, 1e+86, 1e+87, 1e+88, 1e+89, 1e+90, 1e+91, 1e+92, 1e+93, 1e+94, 1e+95, 1e+96, 1e+97, 1e+98, 1e+99, 1e+100,
+		1e+101,1e+102,1e+103,1e+104,1e+105,1e+106,1e+107,1e+108,1e+109,1e+110,1e+111,1e+112,1e+113,1e+114,1e+115,1e+116,1e+117,1e+118,1e+119,1e+120,
+		1e+121,1e+122,1e+123,1e+124,1e+125,1e+126,1e+127,1e+128,1e+129,1e+130,1e+131,1e+132,1e+133,1e+134,1e+135,1e+136,1e+137,1e+138,1e+139,1e+140,
+		1e+141,1e+142,1e+143,1e+144,1e+145,1e+146,1e+147,1e+148,1e+149,1e+150,1e+151,1e+152,1e+153,1e+154,1e+155,1e+156,1e+157,1e+158,1e+159,1e+160,
+		1e+161,1e+162,1e+163,1e+164,1e+165,1e+166,1e+167,1e+168,1e+169,1e+170,1e+171,1e+172,1e+173,1e+174,1e+175,1e+176,1e+177,1e+178,1e+179,1e+180,
+		1e+181,1e+182,1e+183,1e+184,1e+185,1e+186,1e+187,1e+188,1e+189,1e+190,1e+191,1e+192,1e+193,1e+194,1e+195,1e+196,1e+197,1e+198,1e+199,1e+200,
+		1e+201,1e+202,1e+203,1e+204,1e+205,1e+206,1e+207,1e+208,1e+209,1e+210,1e+211,1e+212,1e+213,1e+214,1e+215,1e+216,1e+217,1e+218,1e+219,1e+220,
+		1e+221,1e+222,1e+223,1e+224,1e+225,1e+226,1e+227,1e+228,1e+229,1e+230,1e+231,1e+232,1e+233,1e+234,1e+235,1e+236,1e+237,1e+238,1e+239,1e+240,
+		1e+241,1e+242,1e+243,1e+244,1e+245,1e+246,1e+247,1e+248,1e+249,1e+250,1e+251,1e+252,1e+253,1e+254,1e+255,1e+256,1e+257,1e+258,1e+259,1e+260,
+		1e+261,1e+262,1e+263,1e+264,1e+265,1e+266,1e+267,1e+268,1e+269,1e+270,1e+271,1e+272,1e+273,1e+274,1e+275,1e+276,1e+277,1e+278,1e+279,1e+280,
+		1e+281,1e+282,1e+283,1e+284,1e+285,1e+286,1e+287,1e+288,1e+289,1e+290,1e+291,1e+292,1e+293,1e+294,1e+295,1e+296,1e+297,1e+298,1e+299,1e+300,
+		1e+301,1e+302,1e+303,1e+304,1e+305,1e+306,1e+307,1e+308
+	};
+	RAPIDJSON_ASSERT(n <= 308);
+	return n < -308 ? 0.0 : e[n + 308];
+}
+
+} // namespace internal
+} // namespace rapidjson
+
+#endif // RAPIDJSON_POW10_

include/rapidjson/internal/stack.h

+#ifndef RAPIDJSON_INTERNAL_STACK_H_
+#define RAPIDJSON_INTERNAL_STACK_H_
+
+namespace rapidjson {
+namespace internal {
+
+///////////////////////////////////////////////////////////////////////////////
+// Stack
+
+//! A type-unsafe stack for storing different types of data.
+/*! \tparam Allocator Allocator for allocating stack memory.
+*/
+template <typename Allocator>
+class Stack {
+public:
+	Stack(Allocator* allocator, size_t stack_capacity) : allocator_(allocator), own_allocator_(0), stack_(0), stack_top_(0), stack_end_(0), stack_capacity_(stack_capacity) {
+		RAPIDJSON_ASSERT(stack_capacity_ > 0);
+		if (!allocator_)
+			own_allocator_ = allocator_ = new Allocator();
+		stack_top_ = stack_ = (char*)allocator_->Malloc(stack_capacity_);
+		stack_end_ = stack_ + stack_capacity_;
+	}
+
+	~Stack() {
+		Allocator::Free(stack_);
+		delete own_allocator_; // Only delete if it is owned by the stack
+	}
+
+	void Clear() { /*stack_top_ = 0;*/ stack_top_ = stack_; }
+
+	template<typename T>
+	T* Push(size_t count = 1) {
+		 // Expand the stack if needed
+		if (stack_top_ + sizeof(T) * count >= stack_end_) {
+			size_t new_capacity = stack_capacity_ * 2;
+			size_t size = GetSize();
+			size_t new_size = GetSize() + sizeof(T) * count;
+			if (new_capacity < new_size)
+				new_capacity = new_size;
+			stack_ = (char*)allocator_->Realloc(stack_, stack_capacity_, new_capacity);
+			stack_capacity_ = new_capacity;
+			stack_top_ = stack_ + size;
+			stack_end_ = stack_ + stack_capacity_;
+		}
+		T* ret = (T*)stack_top_;
+		stack_top_ += sizeof(T) * count;
+		return ret;
+	}
+
+	template<typename T>
+	T* Pop(size_t count) {
+		RAPIDJSON_ASSERT(GetSize() >= count * sizeof(T));
+		stack_top_ -= count * sizeof(T);
+		return (T*)stack_top_;
+	}
+
+	template<typename T>
+	T* Top() { 
+		RAPIDJSON_ASSERT(GetSize() >= sizeof(T));
+		return (T*)(stack_top_ - sizeof(T));
+	}
+
+	template<typename T>
+	T* Bottom() { return (T*)stack_; }
+
+	Allocator& GetAllocator() { return *allocator_; }
+	size_t GetSize() const { /*return stack_top_;*/ return stack_top_ - stack_; }
+	size_t GetCapacity() const { return stack_capacity_; }
+
+private:
+	Allocator* allocator_;
+	Allocator* own_allocator_;
+	char *stack_;
+	char *stack_top_;
+	char *stack_end_;
+	size_t stack_capacity_;
+};
+
+} // namespace internal
+} // namespace rapidjson
+
+#endif // RAPIDJSON_STACK_H_

include/rapidjson/internal/strfunc.h

+#ifndef RAPIDJSON_INTERNAL_STRFUNC_H_
+#define RAPIDJSON_INTERNAL_STRFUNC_H_
+
+namespace rapidjson {
+namespace internal {
+
+//! Custom strlen() which works on different character types.
+/*!	\tparam Ch Character type (e.g. char, wchar_t, short)
+	\param s Null-terminated input string.
+	\return Number of characters in the string. 
+	\note This has the same semantics as strlen(), the return value is not number of Unicode codepoints.
+*/
+template <typename Ch>
+inline SizeType StrLen(const Ch* s) {
+	const Ch* p = s;
+	while (*p != '\0')
+		++p;
+	return SizeType(p - s);
+}
+
+} // namespace internal
+} // namespace rapidjson
+
+#endif // RAPIDJSON_INTERNAL_STRFUNC_H_

include/rapidjson/prettywriter.h

+#ifndef RAPIDJSON_PRETTYWRITER_H_
+#define RAPIDJSON_PRETTYWRITER_H_
+
+#include "writer.h"
+
+namespace rapidjson {
+
+//! Writer with indentation and spacing.
+/*!
+	\tparam Stream Type of ouptut stream.
+	\tparam Encoding Encoding of both source strings and output.
+	\tparam Allocator Type of allocator for allocating memory of stack.
+*/
+template<typename Stream, typename Encoding = UTF8<>, typename Allocator = MemoryPoolAllocator<> >
+class PrettyWriter : public Writer<Stream, Encoding, Allocator> {
+public:
+	typedef Writer<Stream, Encoding, Allocator> Base;
+	typedef typename Base::Ch Ch;
+
+	//! Constructor
+	/*! \param stream Output stream.
+		\param allocator User supplied allocator. If it is null, it will create a private one.
+		\param levelDepth Initial capacity of 
+	*/
+	PrettyWriter(Stream& stream, Allocator* allocator = 0, size_t levelDepth = Base::kDefaultLevelDepth) : 
+		Base(stream, allocator, levelDepth), indentChar_(' '), indentCharCount_(4) {}
+
+	//! Set custom indentation.
+	/*! \param indentChar		Character for indentation. Must be whitespace character (' ', '\t', '\n', '\r').
+		\param indentCharCount	Number of indent characters for each indentation level.
+		\note The default indentation is 4 spaces.
+	*/
+	PrettyWriter& SetIndent(Ch indentChar, unsigned indentCharCount) {
+		RAPIDJSON_ASSERT(indentChar == ' ' || indentChar == '\t' || indentChar == '\n' || indentChar == '\r');
+		indentChar_ = indentChar;
+		indentCharCount_ = indentCharCount;
+		return *this;
+	}
+
+	//@name Implementation of Handler.
+	//@{
+
+	PrettyWriter& Null()				{ PrettyPrefix(kNullType);   Base::WriteNull();			return *this; }
+	PrettyWriter& Bool(bool b)			{ PrettyPrefix(b ? kTrueType : kFalseType); Base::WriteBool(b); return *this; }
+	PrettyWriter& Int(int i)			{ PrettyPrefix(kNumberType); Base::WriteInt(i);			return *this; }
+	PrettyWriter& Uint(unsigned u)		{ PrettyPrefix(kNumberType); Base::WriteUint(u);		return *this; }
+	PrettyWriter& Int64(int64_t i64)	{ PrettyPrefix(kNumberType); Base::WriteInt64(i64);		return *this; }
+	PrettyWriter& Uint64(uint64_t u64)	{ PrettyPrefix(kNumberType); Base::WriteUint64(u64);	return *this; }
+	PrettyWriter& Double(double d)		{ PrettyPrefix(kNumberType); Base::WriteDouble(d);		return *this; }
+
+	PrettyWriter& String(const Ch* str, SizeType length, bool copy = false) {
+		PrettyPrefix(kStringType);
+		Base::WriteString(str, length);
+		return *this;
+	}
+
+	PrettyWriter& StartObject() {
+		PrettyPrefix(kObjectType);
+		new (Base::level_stack_.template Push<typename Base::Level>()) typename Base::Level(false);
+		Base::WriteStartObject();
+		return *this;
+	}
+
+	PrettyWriter& EndObject(SizeType memberCount = 0) {
+		RAPIDJSON_ASSERT(Base::level_stack_.GetSize() >= sizeof(typename Base::Level));
+		RAPIDJSON_ASSERT(!Base::level_stack_.template Top<typename Base::Level>()->inArray);
+		bool empty = Base::level_stack_.template Pop<typename Base::Level>(1)->valueCount == 0;
+
+		if (!empty) {
+			Base::stream_.Put('\n');
+			WriteIndent();
+		}
+		Base::WriteEndObject();
+		return *this;
+	}
+
+	PrettyWriter& StartArray() {
+		PrettyPrefix(kArrayType);
+		new (Base::level_stack_.template Push<typename Base::Level>()) typename Base::Level(true);
+		Base::WriteStartArray();
+		return *this;
+	}
+
+	PrettyWriter& EndArray(SizeType memberCount = 0) {
+		RAPIDJSON_ASSERT(Base::level_stack_.GetSize() >= sizeof(typename Base::Level));
+		RAPIDJSON_ASSERT(Base::level_stack_.template Top<typename Base::Level>()->inArray);
+		bool empty = Base::level_stack_.template Pop<typename Base::Level>(1)->valueCount == 0;
+
+		if (!empty) {
+			Base::stream_.Put('\n');
+			WriteIndent();
+		}
+		Base::WriteEndArray();
+		return *this;
+	}
+
+	//@}
+
+	//! Simpler but slower overload.
+	PrettyWriter& String(const Ch* str) { return String(str, internal::StrLen(str)); }
+
+protected:
+	void PrettyPrefix(Type type) {
+		if (Base::level_stack_.GetSize() != 0) { // this value is not at root
+			typename Base::Level* level = Base::level_stack_.template Top<typename Base::Level>();
+
+			if (level->inArray) {
+				if (level->valueCount > 0) {
+					Base::stream_.Put(','); // add comma if it is not the first element in array
+					Base::stream_.Put('\n');
+				}
+				else
+					Base::stream_.Put('\n');
+				WriteIndent();
+			}
+			else {	// in object
+				if (level->valueCount > 0) {
+					if (level->valueCount % 2 == 0) {
+						Base::stream_.Put(',');
+						Base::stream_.Put('\n');
+					}
+					else {
+						Base::stream_.Put(':');
+						Base::stream_.Put(' ');
+					}
+				}
+				else
+					Base::stream_.Put('\n');
+
+				if (level->valueCount % 2 == 0)
+					WriteIndent();
+			}
+			if (!level->inArray && level->valueCount % 2 == 0)
+				RAPIDJSON_ASSERT(type == kStringType);  // if it's in object, then even number should be a name
+			level->valueCount++;
+		}
+		else
+			RAPIDJSON_ASSERT(type == kObjectType || type == kArrayType);
+	}
+
+	void WriteIndent()  {
+		size_t count = (Base::level_stack_.GetSize() / sizeof(typename Base::Level)) * indentCharCount_;
+		PutN(Base::stream_, indentChar_, count);
+	}
+
+	Ch indentChar_;
+	unsigned indentCharCount_;
+};
+
+} // namespace rapidjson
+
+#endif // RAPIDJSON_RAPIDJSON_H_

include/rapidjson/stringbuffer.h

+#ifndef RAPIDJSON_STRINGBUFFER_H_
+#define RAPIDJSON_STRINGBUFFER_H_
+
+#include "rapidjson.h"
+#include "internal/stack.h"
+
+namespace rapidjson {
+
+//! Represents an in-memory output stream.
+/*!
+	\tparam Encoding Encoding of the stream.
+	\tparam Allocator type for allocating memory buffer.
+	\implements Stream
+*/
+template <typename Encoding, typename Allocator = CrtAllocator>
+struct GenericStringBuffer {
+	typedef typename Encoding::Ch Ch;
+
+	GenericStringBuffer(Allocator* allocator = 0, size_t capacity = kDefaultCapacity) : stack_(allocator, capacity) {}
+
+	void Put(Ch c) { *stack_.template Push<Ch>() = c; }
+
+	void Clear() { stack_.Clear(); }
+
+	const char* GetString() const {
+		// Push and pop a null terminator. This is safe.
+		*stack_.template Push<Ch>() = '\0';
+		stack_.template Pop<Ch>(1);
+
+		return stack_.template Bottom<Ch>();
+	}
+
+	size_t Size() const { return stack_.Size(); }
+
+	static const size_t kDefaultCapacity = 256;
+	mutable internal::Stack<Allocator> stack_;
+};
+
+typedef GenericStringBuffer<UTF8<> > StringBuffer;
+
+//! Implement specialized version of PutN() with memset() for better performance.
+template<>
+inline void PutN(GenericStringBuffer<UTF8<> >& stream, char c, size_t n) {
+	memset(stream.stack_.Push<char>(n), c, n * sizeof(c));
+}
+
+} // namespace rapidjson
+
+#endif // RAPIDJSON_STRINGBUFFER_H_

license.txt

+Copyright (C) 2011 Milo Yip
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
\ No newline at end of file