1 #ifndef RAPIDJSON_WRITER_H_
2 #define RAPIDJSON_WRITER_H_
5 #include "internal/stack.h"
6 #include "internal/strfunc.h"
7 #include <cstdio> // snprintf() or _sprintf_s()
8 #include <new> // placement new
13 #pragma warning(disable : 4127) // conditional expression is constant
19 /*! Writer implements the concept Handler.
20 It generates JSON text by events to an output stream.
22 User may programmatically calls the functions of a writer to generate JSON text.
24 On the other side, a writer can also be passed to objects that generates events,
26 for example Reader::Parse() and Document::Accept().
28 \tparam Stream Type of ouptut stream.
29 \tparam Encoding Encoding of both source strings and output.
32 template<typename Stream, typename Encoding = UTF8<>, typename Allocator = MemoryPoolAllocator<> >
35 typedef typename Encoding::Ch Ch;
37 Writer(Stream& stream, int precision = 20, Allocator* allocator = 0, size_t levelDepth = kDefaultLevelDepth) :
38 stream_(stream), level_stack_(allocator, levelDepth * sizeof(Level))
41 (void) sprintf_s(double_format, sizeof(double_format), "%%0.%dg", precision);
42 (void) sprintf_s( long_double_format, sizeof( long_double_format ), "%%0.%dLg", precision );
44 (void) snprintf(double_format, sizeof(double_format), "%%0.%dg", precision);
45 (void) snprintf( long_double_format, sizeof( long_double_format ), "%%0.%dLg", precision );
51 char double_format[32];
52 char long_double_format[32];
55 //@name Implementation of Handler
58 Writer& Null_() { Prefix(kNull_Type); WriteNull_(); return *this; }
59 Writer& Bool_(bool b) { Prefix(b ? kTrueType : kFalseType); WriteBool_(b); return *this; }
60 Writer& Int(int i) { Prefix(kNumberType); WriteInt(i); return *this; }
61 Writer& Uint(unsigned u) { Prefix(kNumberType); WriteUint(u); return *this; }
62 Writer& Int64(int64_t i64) { Prefix(kNumberType); WriteInt64(i64); return *this; }
63 Writer& Uint64(uint64_t u64) { Prefix(kNumberType); WriteUint64(u64); return *this; }
64 Writer& Double(double d) { Prefix(kNumberType); WriteDouble(d); return *this; }
65 Writer& LongDouble(long double d) { Prefix(kNumberType); WriteLongDouble(d); return *this; }
66 Writer& LongLong(long long d) { Prefix(kNumberType); WriteLongLong(d); return *this; }
67 Writer& ULongLong(unsigned long long d) { Prefix(kNumberType); WriteULongLong(d); return *this; }
69 Writer& String(const Ch* str, SizeType length, bool copy = false) {
72 WriteString(str, length);
76 Writer& StartObject() {
78 new (level_stack_.template Push<Level>()) Level(false);
83 Writer& EndObject(SizeType memberCount = 0) {
85 RAPIDJSON_ASSERT(level_stack_.GetSize() >= sizeof(Level));
86 RAPIDJSON_ASSERT(!level_stack_.template Top<Level>()->inArray);
87 level_stack_.template Pop<Level>(1);
92 Writer& StartArray() {
94 new (level_stack_.template Push<Level>()) Level(true);
99 Writer& EndArray(SizeType elementCount = 0) {
101 RAPIDJSON_ASSERT(level_stack_.GetSize() >= sizeof(Level));
102 RAPIDJSON_ASSERT(level_stack_.template Top<Level>()->inArray);
103 level_stack_.template Pop<Level>(1);
109 //! Simpler but slower overload.
110 Writer& String(const Ch* str) { return String(str, internal::StrLen(str)); }
113 //! Information for each nested level
115 Level(bool inArray_) : inArray(inArray_), valueCount(0) {}
116 bool inArray; //!< true if in array, otherwise in object
117 size_t valueCount; //!< number of values in this level
120 static const size_t kDefaultLevelDepth = 32;
123 stream_.Put('n'); stream_.Put('u'); stream_.Put('l'); stream_.Put('l');
126 void WriteBool_(bool b) {
128 stream_.Put('t'); stream_.Put('r'); stream_.Put('u'); stream_.Put('e');
131 stream_.Put('f'); stream_.Put('a'); stream_.Put('l'); stream_.Put('s'); stream_.Put('e');
135 void WriteInt(int i) {
140 WriteUint((unsigned)i);
143 void WriteUint(unsigned u) {
147 *p++ = (u % 10) + '0';
154 } while (p != buffer);
157 void WriteInt64(int64_t i64) {
162 WriteUint64((uint64_t)i64);
165 void WriteUint64(uint64_t u64) {
169 *p++ = char(u64 % 10) + '0';
176 } while (p != buffer);
179 // cereal Temporary until constexpr support is added in RTM
182 bool characterOk( Ch c )
188 // As part of a fix for GCC 4.7
190 static constexpr int to_int( T t ){ return t; }
193 typename std::enable_if < to_int(std::numeric_limits<Ch>::max()) < to_int(256), bool>::type
200 typename std::enable_if< to_int(std::numeric_limits<Ch>::max()) >= to_int(256), bool>::type
205 //! \todo Optimization with custom double-to-string converter.
206 void WriteDouble(double d) {
209 int ret = sprintf_s(buffer, sizeof(buffer), double_format, d);
211 int ret = snprintf(buffer, sizeof(buffer), double_format, d);
213 RAPIDJSON_ASSERT(ret >= 1);
214 for (int i = 0; i < ret; i++)
215 stream_.Put(buffer[i]);
218 void WriteLongDouble(long double d) {
221 int ret = sprintf_s(buffer, sizeof(buffer), long_double_format, d);
223 int ret = snprintf(buffer, sizeof(buffer), long_double_format, d);
225 RAPIDJSON_ASSERT(ret >= 1);
226 for (int i = 0; i < ret; i++)
227 stream_.Put(buffer[i]);
230 void WriteLongLong(long long d) {
233 int ret = sprintf_s(buffer, sizeof(buffer), "%lld", d);
235 int ret = snprintf(buffer, sizeof(buffer), "%lld", d);
237 RAPIDJSON_ASSERT(ret >= 1);
238 for (int i = 0; i < ret; i++)
239 stream_.Put(buffer[i]);
242 void WriteULongLong(unsigned long long d) {
245 int ret = sprintf_s(buffer, sizeof(buffer), "%llu", d);
247 int ret = snprintf(buffer, sizeof(buffer), "%llu", d);
249 RAPIDJSON_ASSERT(ret >= 1);
250 for (int i = 0; i < ret; i++)
251 stream_.Put(buffer[i]);
254 void WriteString(const Ch* str, SizeType length) {
255 static const char hexDigits[] = "0123456789ABCDEF";
256 static const char escape[256] = {
257 #define Z16 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0
258 //0 1 2 3 4 5 6 7 8 9 A B C D E F
259 'u', 'u', 'u', 'u', 'u', 'u', 'u', 'u', 'b', 't', 'n', 'u', 'f', 'r', 'u', 'u', // 00
260 'u', 'u', 'u', 'u', 'u', 'u', 'u', 'u', 'u', 'u', 'u', 'u', 'u', 'u', 'u', 'u', // 10
261 0, 0, '"', 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, // 20
263 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,'\\', 0, 0, 0, // 50
264 Z16, Z16, Z16, Z16, Z16, Z16, Z16, Z16, Z16, Z16 // 60~FF
269 for (const Ch* p = str; p != str + length; ++p) {
270 if ((sizeof(Ch) == 1 || characterOk(*p)) && escape[(unsigned char)*p]) {
271 //if ((sizeof(Ch) == 1 || *p < 256) && escape[(unsigned char)*p]) {
273 stream_.Put(escape[(unsigned char)*p]);
274 if (escape[(unsigned char)*p] == 'u') {
277 stream_.Put(hexDigits[(*p) >> 4]);
278 stream_.Put(hexDigits[(*p) & 0xF]);
287 void WriteStartObject() { stream_.Put('{'); }
288 void WriteEndObject() { stream_.Put('}'); }
289 void WriteStartArray() { stream_.Put('['); }
290 void WriteEndArray() { stream_.Put(']'); }
292 void Prefix(Type type) {
294 if (level_stack_.GetSize() != 0) { // this value is not at root
295 Level* level = level_stack_.template Top<Level>();
296 if (level->valueCount > 0) {
298 stream_.Put(','); // add comma if it is not the first element in array
300 stream_.Put((level->valueCount % 2 == 0) ? ',' : ':');
302 if (!level->inArray && level->valueCount % 2 == 0)
303 RAPIDJSON_ASSERT(type == kStringType); // if it's in object, then even number should be a name
307 RAPIDJSON_ASSERT(type == kObjectType || type == kArrayType);
311 internal::Stack<Allocator> level_stack_;
314 // Prohibit assignment for VC C4512 warning
315 Writer& operator=(const Writer& w);
318 } // namespace rapidjson
324 #endif // RAPIDJSON_RAPIDJSON_H_