Use std::string in folly::dynamic
[folly.git] / folly / json.cpp
1 /*
2  * Copyright 2016 Facebook, Inc.
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *   http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16
17 #include <folly/json.h>
18 #include <cassert>
19 #include <boost/next_prior.hpp>
20 #include <boost/algorithm/string.hpp>
21
22 #include <folly/Conv.h>
23 #include <folly/Portability.h>
24 #include <folly/Range.h>
25 #include <folly/String.h>
26 #include <folly/Unicode.h>
27 #include <folly/portability/Constexpr.h>
28
29 namespace folly {
30
31 //////////////////////////////////////////////////////////////////////
32
33 namespace json {
34 namespace {
35
36 char32_t decodeUtf8(
37     const unsigned char*& p,
38     const unsigned char* const e,
39     bool skipOnError) {
40   /* The following encodings are valid, except for the 5 and 6 byte
41    * combinations:
42    * 0xxxxxxx
43    * 110xxxxx 10xxxxxx
44    * 1110xxxx 10xxxxxx 10xxxxxx
45    * 11110xxx 10xxxxxx 10xxxxxx 10xxxxxx
46    * 111110xx 10xxxxxx 10xxxxxx 10xxxxxx 10xxxxxx
47    * 1111110x 10xxxxxx 10xxxxxx 10xxxxxx 10xxxxxx 10xxxxxx
48    */
49
50   auto skip = [&] { ++p; return U'\ufffd'; };
51
52   if (p >= e) {
53     if (skipOnError) return skip();
54     throw std::runtime_error("folly::decodeUtf8 empty/invalid string");
55   }
56
57   unsigned char fst = *p;
58   if (!(fst & 0x80)) {
59     // trivial case
60     return *p++;
61   }
62
63   static const uint32_t bitMask[] = {
64     (1 << 7) - 1,
65     (1 << 11) - 1,
66     (1 << 16) - 1,
67     (1 << 21) - 1
68   };
69
70   // upper control bits are masked out later
71   uint32_t d = fst;
72
73   if ((fst & 0xC0) != 0xC0) {
74     if (skipOnError) return skip();
75     throw std::runtime_error(to<std::string>("folly::decodeUtf8 i=0 d=", d));
76   }
77
78   fst <<= 1;
79
80   for (unsigned int i = 1; i != 3 && p + i < e; ++i) {
81     unsigned char tmp = p[i];
82
83     if ((tmp & 0xC0) != 0x80) {
84       if (skipOnError) return skip();
85       throw std::runtime_error(
86         to<std::string>("folly::decodeUtf8 i=", i, " tmp=", (uint32_t)tmp));
87     }
88
89     d = (d << 6) | (tmp & 0x3F);
90     fst <<= 1;
91
92     if (!(fst & 0x80)) {
93       d &= bitMask[i];
94
95       // overlong, could have been encoded with i bytes
96       if ((d & ~bitMask[i - 1]) == 0) {
97         if (skipOnError) return skip();
98         throw std::runtime_error(
99           to<std::string>("folly::decodeUtf8 i=", i, " d=", d));
100       }
101
102       // check for surrogates only needed for 3 bytes
103       if (i == 2) {
104         if ((d >= 0xD800 && d <= 0xDFFF) || d > 0x10FFFF) {
105           if (skipOnError) return skip();
106           throw std::runtime_error(
107             to<std::string>("folly::decodeUtf8 i=", i, " d=", d));
108         }
109       }
110
111       p += i + 1;
112       return d;
113     }
114   }
115
116   if (skipOnError) return skip();
117   throw std::runtime_error("folly::decodeUtf8 encoding length maxed out");
118 }
119
120 struct Printer {
121   explicit Printer(
122       std::string& out,
123       unsigned* indentLevel,
124       serialization_opts const* opts)
125       : out_(out), indentLevel_(indentLevel), opts_(*opts) {}
126
127   void operator()(dynamic const& v) const {
128     switch (v.type()) {
129     case dynamic::DOUBLE:
130       if (!opts_.allow_nan_inf &&
131           (std::isnan(v.asDouble()) || std::isinf(v.asDouble()))) {
132         throw std::runtime_error("folly::toJson: JSON object value was a "
133           "NaN or INF");
134       }
135       toAppend(v.asDouble(), &out_, opts_.double_mode, opts_.double_num_digits);
136       break;
137     case dynamic::INT64: {
138       auto intval = v.asInt();
139       if (opts_.javascript_safe) {
140         // Use folly::to to check that this integer can be represented
141         // as a double without loss of precision.
142         intval = int64_t(to<double>(intval));
143       }
144       toAppend(intval, &out_);
145       break;
146     }
147     case dynamic::BOOL:
148       out_ += v.asBool() ? "true" : "false";
149       break;
150     case dynamic::NULLT:
151       out_ += "null";
152       break;
153     case dynamic::STRING:
154       escapeString(v.asString(), out_, opts_);
155       break;
156     case dynamic::OBJECT:
157       printObject(v);
158       break;
159     case dynamic::ARRAY:
160       printArray(v);
161       break;
162     default:
163       CHECK(0) << "Bad type " << v.type();
164     }
165   }
166
167 private:
168   void printKV(const std::pair<const dynamic, dynamic>& p) const {
169     if (!opts_.allow_non_string_keys && !p.first.isString()) {
170       throw std::runtime_error("folly::toJson: JSON object key was not a "
171         "string");
172     }
173     (*this)(p.first);
174     mapColon();
175     (*this)(p.second);
176   }
177
178   template <typename Iterator>
179   void printKVPairs(Iterator begin, Iterator end) const {
180     printKV(*begin);
181     for (++begin; begin != end; ++begin) {
182       out_ += ',';
183       newline();
184       printKV(*begin);
185     }
186   }
187
188   void printObject(dynamic const& o) const {
189     if (o.empty()) {
190       out_ += "{}";
191       return;
192     }
193
194     out_ += '{';
195     indent();
196     newline();
197     if (opts_.sort_keys) {
198       std::vector<std::pair<dynamic, dynamic>> items(
199         o.items().begin(), o.items().end());
200       std::sort(items.begin(), items.end());
201       printKVPairs(items.begin(), items.end());
202     } else {
203       printKVPairs(o.items().begin(), o.items().end());
204     }
205     outdent();
206     newline();
207     out_ += '}';
208   }
209
210   void printArray(dynamic const& a) const {
211     if (a.empty()) {
212       out_ += "[]";
213       return;
214     }
215
216     out_ += '[';
217     indent();
218     newline();
219     (*this)(a[0]);
220     for (auto& val : range(boost::next(a.begin()), a.end())) {
221       out_ += ',';
222       newline();
223       (*this)(val);
224     }
225     outdent();
226     newline();
227     out_ += ']';
228   }
229
230 private:
231   void outdent() const {
232     if (indentLevel_) {
233       --*indentLevel_;
234     }
235   }
236
237   void indent() const {
238     if (indentLevel_) {
239       ++*indentLevel_;
240     }
241   }
242
243   void newline() const {
244     if (indentLevel_) {
245       out_ += to<std::string>('\n', std::string(*indentLevel_ * 2, ' '));
246     }
247   }
248
249   void mapColon() const {
250     out_ += indentLevel_ ? " : " : ":";
251   }
252
253 private:
254  std::string& out_;
255  unsigned* const indentLevel_;
256  serialization_opts const& opts_;
257 };
258
259   //////////////////////////////////////////////////////////////////////
260
261   struct ParseError : std::runtime_error {
262     explicit ParseError(int line)
263       : std::runtime_error(to<std::string>("json parse error on line ", line))
264     {}
265
266     explicit ParseError(int line, std::string const& context,
267         std::string const& expected)
268       : std::runtime_error(to<std::string>("json parse error on line ", line,
269           !context.empty() ? to<std::string>(" near `", context, '\'')
270                           : "",
271           ": ", expected))
272     {}
273
274     explicit ParseError(std::string const& msg)
275       : std::runtime_error("json parse error: " + msg)
276     {}
277   };
278
279 // Wraps our input buffer with some helper functions.
280 struct Input {
281   explicit Input(StringPiece range, json::serialization_opts const* opts)
282       : range_(range)
283       , opts_(*opts)
284       , lineNum_(0)
285   {
286     storeCurrent();
287   }
288
289   Input(Input const&) = delete;
290   Input& operator=(Input const&) = delete;
291
292   char const* begin() const { return range_.begin(); }
293
294   // Parse ahead for as long as the supplied predicate is satisfied,
295   // returning a range of what was skipped.
296   template<class Predicate>
297   StringPiece skipWhile(const Predicate& p) {
298     std::size_t skipped = 0;
299     for (; skipped < range_.size(); ++skipped) {
300       if (!p(range_[skipped])) {
301         break;
302       }
303       if (range_[skipped] == '\n') {
304         ++lineNum_;
305       }
306     }
307     auto ret = range_.subpiece(0, skipped);
308     range_.advance(skipped);
309     storeCurrent();
310     return ret;
311   }
312
313   StringPiece skipDigits() {
314     return skipWhile([] (char c) { return c >= '0' && c <= '9'; });
315   }
316
317   StringPiece skipMinusAndDigits() {
318     bool firstChar = true;
319     return skipWhile([&firstChar] (char c) {
320         bool result = (c >= '0' && c <= '9') || (firstChar && c == '-');
321         firstChar = false;
322         return result;
323       });
324   }
325
326   void skipWhitespace() {
327     range_ = folly::skipWhitespace(range_);
328     storeCurrent();
329   }
330
331   void expect(char c) {
332     if (**this != c) {
333       throw ParseError(lineNum_, context(),
334         to<std::string>("expected '", c, '\''));
335     }
336     ++*this;
337   }
338
339   std::size_t size() const {
340     return range_.size();
341   }
342
343   int operator*() const {
344     return current_;
345   }
346
347   void operator++() {
348     range_.pop_front();
349     storeCurrent();
350   }
351
352   template<class T>
353   T extract() {
354     try {
355       return to<T>(&range_);
356     } catch (std::exception const& e) {
357       error(e.what());
358     }
359   }
360
361   bool consume(StringPiece str) {
362     if (boost::starts_with(range_, str)) {
363       range_.advance(str.size());
364       storeCurrent();
365       return true;
366     }
367     return false;
368   }
369
370   std::string context() const {
371     return range_.subpiece(0, 16 /* arbitrary */).toString();
372   }
373
374   dynamic error(char const* what) const {
375     throw ParseError(lineNum_, context(), what);
376   }
377
378   json::serialization_opts const& getOpts() {
379     return opts_;
380   }
381
382 private:
383   void storeCurrent() {
384     current_ = range_.empty() ? EOF : range_.front();
385   }
386
387 private:
388   StringPiece range_;
389   json::serialization_opts const& opts_;
390   unsigned lineNum_;
391   int current_;
392 };
393
394 dynamic parseValue(Input& in);
395 std::string parseString(Input& in);
396 dynamic parseNumber(Input& in);
397
398 dynamic parseObject(Input& in) {
399   assert(*in == '{');
400   ++in;
401
402   dynamic ret = dynamic::object;
403
404   in.skipWhitespace();
405   if (*in == '}') {
406     ++in;
407     return ret;
408   }
409
410   for (;;) {
411     if (in.getOpts().allow_trailing_comma && *in == '}') {
412       break;
413     }
414     if (*in == '\"') { // string
415       auto key = parseString(in);
416       in.skipWhitespace();
417       in.expect(':');
418       in.skipWhitespace();
419       ret.insert(std::move(key), parseValue(in));
420     } else if (!in.getOpts().allow_non_string_keys) {
421       in.error("expected string for object key name");
422     } else {
423       auto key = parseValue(in);
424       in.skipWhitespace();
425       in.expect(':');
426       in.skipWhitespace();
427       ret.insert(std::move(key), parseValue(in));
428     }
429
430     in.skipWhitespace();
431     if (*in != ',') {
432       break;
433     }
434     ++in;
435     in.skipWhitespace();
436   }
437   in.expect('}');
438
439   return ret;
440 }
441
442 dynamic parseArray(Input& in) {
443   assert(*in == '[');
444   ++in;
445
446   dynamic ret = dynamic::array;
447
448   in.skipWhitespace();
449   if (*in == ']') {
450     ++in;
451     return ret;
452   }
453
454   for (;;) {
455     if (in.getOpts().allow_trailing_comma && *in == ']') {
456       break;
457     }
458     ret.push_back(parseValue(in));
459     in.skipWhitespace();
460     if (*in != ',') {
461       break;
462     }
463     ++in;
464     in.skipWhitespace();
465   }
466   in.expect(']');
467
468   return ret;
469 }
470
471 dynamic parseNumber(Input& in) {
472   bool const negative = (*in == '-');
473   if (negative && in.consume("-Infinity")) {
474     if (in.getOpts().parse_numbers_as_strings) {
475       return "-Infinity";
476     } else {
477       return -std::numeric_limits<double>::infinity();
478     }
479   }
480
481   auto integral = in.skipMinusAndDigits();
482   if (negative && integral.size() < 2) {
483     in.error("expected digits after `-'");
484   }
485
486   auto const wasE = *in == 'e' || *in == 'E';
487
488   constexpr const char* maxInt = "9223372036854775807";
489   constexpr const char* minInt = "9223372036854775808";
490   constexpr auto maxIntLen = constexpr_strlen(maxInt);
491
492
493   if (*in != '.' && !wasE && in.getOpts().parse_numbers_as_strings) {
494     return integral;
495   }
496
497   if (*in != '.' && !wasE) {
498     if (LIKELY(!in.getOpts().double_fallback || integral.size() < maxIntLen) ||
499          (integral.size() == maxIntLen &&
500            (integral <= maxInt || (integral == minInt && negative)))) {
501       auto val = to<int64_t>(integral);
502       in.skipWhitespace();
503       return val;
504     } else {
505       auto val = to<double>(integral);
506       in.skipWhitespace();
507       return val;
508     }
509   }
510
511   auto end = !wasE ? (++in, in.skipDigits().end()) : in.begin();
512   if (*in == 'e' || *in == 'E') {
513     ++in;
514     if (*in == '+' || *in == '-') {
515       ++in;
516     }
517     auto expPart = in.skipDigits();
518     end = expPart.end();
519   }
520   auto fullNum = range(integral.begin(), end);
521   if (in.getOpts().parse_numbers_as_strings) {
522     return fullNum;
523   }
524   auto val = to<double>(fullNum);
525   return val;
526 }
527
528 std::string decodeUnicodeEscape(Input& in) {
529   auto hexVal = [&] (char c) -> unsigned {
530     return c >= '0' && c <= '9' ? c - '0' :
531            c >= 'a' && c <= 'f' ? c - 'a' + 10 :
532            c >= 'A' && c <= 'F' ? c - 'A' + 10 :
533            (in.error("invalid hex digit"), 0);
534   };
535
536   auto readHex = [&]() -> uint16_t {
537     if (in.size() < 4) {
538       in.error("expected 4 hex digits");
539     }
540
541     uint16_t ret = hexVal(*in) * 4096;
542     ++in;
543     ret += hexVal(*in) * 256;
544     ++in;
545     ret += hexVal(*in) * 16;
546     ++in;
547     ret += hexVal(*in);
548     ++in;
549     return ret;
550   };
551
552   /*
553    * If the value encoded is in the surrogate pair range, we need to
554    * make sure there is another escape that we can use also.
555    */
556   uint32_t codePoint = readHex();
557   if (codePoint >= 0xd800 && codePoint <= 0xdbff) {
558     if (!in.consume("\\u")) {
559       in.error("expected another unicode escape for second half of "
560         "surrogate pair");
561     }
562     uint16_t second = readHex();
563     if (second >= 0xdc00 && second <= 0xdfff) {
564       codePoint = 0x10000 + ((codePoint & 0x3ff) << 10) +
565                   (second & 0x3ff);
566     } else {
567       in.error("second character in surrogate pair is invalid");
568     }
569   } else if (codePoint >= 0xdc00 && codePoint <= 0xdfff) {
570     in.error("invalid unicode code point (in range [0xdc00,0xdfff])");
571   }
572
573   return codePointToUtf8(codePoint);
574 }
575
576 std::string parseString(Input& in) {
577   assert(*in == '\"');
578   ++in;
579
580   std::string ret;
581   for (;;) {
582     auto range = in.skipWhile(
583       [] (char c) { return c != '\"' && c != '\\'; }
584     );
585     ret.append(range.begin(), range.end());
586
587     if (*in == '\"') {
588       ++in;
589       break;
590     }
591     if (*in == '\\') {
592       ++in;
593       switch (*in) {
594       case '\"':    ret.push_back('\"'); ++in; break;
595       case '\\':    ret.push_back('\\'); ++in; break;
596       case '/':     ret.push_back('/');  ++in; break;
597       case 'b':     ret.push_back('\b'); ++in; break;
598       case 'f':     ret.push_back('\f'); ++in; break;
599       case 'n':     ret.push_back('\n'); ++in; break;
600       case 'r':     ret.push_back('\r'); ++in; break;
601       case 't':     ret.push_back('\t'); ++in; break;
602       case 'u':     ++in; ret += decodeUnicodeEscape(in); break;
603       default:
604         in.error(to<std::string>("unknown escape ", *in, " in string").c_str());
605       }
606       continue;
607     }
608     if (*in == EOF) {
609       in.error("unterminated string");
610     }
611     if (!*in) {
612       /*
613        * Apparently we're actually supposed to ban all control
614        * characters from strings.  This seems unnecessarily
615        * restrictive, so we're only banning zero bytes.  (Since the
616        * string is presumed to be UTF-8 encoded it's fine to just
617        * check this way.)
618        */
619       in.error("null byte in string");
620     }
621
622     ret.push_back(*in);
623     ++in;
624   }
625
626   return ret;
627 }
628
629 dynamic parseValue(Input& in) {
630   in.skipWhitespace();
631   return *in == '[' ? parseArray(in) :
632          *in == '{' ? parseObject(in) :
633          *in == '\"' ? parseString(in) :
634          (*in == '-' || (*in >= '0' && *in <= '9')) ? parseNumber(in) :
635          in.consume("true") ? true :
636          in.consume("false") ? false :
637          in.consume("null") ? nullptr :
638          in.consume("Infinity") ?
639           (in.getOpts().parse_numbers_as_strings ? (dynamic)"Infinity" :
640             (dynamic)std::numeric_limits<double>::infinity()) :
641          in.consume("NaN") ?
642            (in.getOpts().parse_numbers_as_strings ? (dynamic)"NaN" :
643              (dynamic)std::numeric_limits<double>::quiet_NaN()) :
644          in.error("expected json value");
645 }
646
647 }
648
649 //////////////////////////////////////////////////////////////////////
650
651 std::string serialize(dynamic const& dyn, serialization_opts const& opts) {
652   std::string ret;
653   unsigned indentLevel = 0;
654   Printer p(ret, opts.pretty_formatting ? &indentLevel : nullptr, &opts);
655   p(dyn);
656   return ret;
657 }
658
659 // Escape a string so that it is legal to print it in JSON text.
660 void escapeString(
661     StringPiece input,
662     std::string& out,
663     const serialization_opts& opts) {
664   auto hexDigit = [] (int c) -> char {
665     return c < 10 ? c + '0' : c - 10 + 'a';
666   };
667
668   out.reserve(out.size() + input.size() + 2);
669   out.push_back('\"');
670
671   auto* p = reinterpret_cast<const unsigned char*>(input.begin());
672   auto* q = reinterpret_cast<const unsigned char*>(input.begin());
673   auto* e = reinterpret_cast<const unsigned char*>(input.end());
674
675   while (p < e) {
676     // Since non-ascii encoding inherently does utf8 validation
677     // we explicitly validate utf8 only if non-ascii encoding is disabled.
678     if ((opts.validate_utf8 || opts.skip_invalid_utf8)
679         && !opts.encode_non_ascii) {
680       // to achieve better spatial and temporal coherence
681       // we do utf8 validation progressively along with the
682       // string-escaping instead of two separate passes
683
684       // as the encoding progresses, q will stay at or ahead of p
685       CHECK(q >= p);
686
687       // as p catches up with q, move q forward
688       if (q == p) {
689         // calling utf8_decode has the side effect of
690         // checking that utf8 encodings are valid
691         char32_t v = decodeUtf8(q, e, opts.skip_invalid_utf8);
692         if (opts.skip_invalid_utf8 && v == U'\ufffd') {
693           out.append(u8"\ufffd");
694           p = q;
695           continue;
696         }
697       }
698     }
699     if (opts.encode_non_ascii && (*p & 0x80)) {
700       // note that this if condition captures utf8 chars
701       // with value > 127, so size > 1 byte
702       char32_t v = decodeUtf8(p, e, opts.skip_invalid_utf8);
703       out.append("\\u");
704       out.push_back(hexDigit(v >> 12));
705       out.push_back(hexDigit((v >> 8) & 0x0f));
706       out.push_back(hexDigit((v >> 4) & 0x0f));
707       out.push_back(hexDigit(v & 0x0f));
708     } else if (*p == '\\' || *p == '\"') {
709       out.push_back('\\');
710       out.push_back(*p++);
711     } else if (*p <= 0x1f) {
712       switch (*p) {
713         case '\b': out.append("\\b"); p++; break;
714         case '\f': out.append("\\f"); p++; break;
715         case '\n': out.append("\\n"); p++; break;
716         case '\r': out.append("\\r"); p++; break;
717         case '\t': out.append("\\t"); p++; break;
718         default:
719           // note that this if condition captures non readable chars
720           // with value < 32, so size = 1 byte (e.g control chars).
721           out.append("\\u00");
722           out.push_back(hexDigit((*p & 0xf0) >> 4));
723           out.push_back(hexDigit(*p & 0xf));
724           p++;
725       }
726     } else {
727       out.push_back(*p++);
728     }
729   }
730
731   out.push_back('\"');
732 }
733
734 std::string stripComments(StringPiece jsonC) {
735   std::string result;
736   enum class State {
737     None,
738     InString,
739     InlineComment,
740     LineComment
741   } state = State::None;
742
743   for (size_t i = 0; i < jsonC.size(); ++i) {
744     auto s = jsonC.subpiece(i);
745     switch (state) {
746       case State::None:
747         if (s.startsWith("/*")) {
748           state = State::InlineComment;
749           ++i;
750           continue;
751         } else if (s.startsWith("//")) {
752           state = State::LineComment;
753           ++i;
754           continue;
755         } else if (s[0] == '\"') {
756           state = State::InString;
757         }
758         result.push_back(s[0]);
759         break;
760       case State::InString:
761         if (s[0] == '\\') {
762           if (UNLIKELY(s.size() == 1)) {
763             throw std::logic_error("Invalid JSONC: string is not terminated");
764           }
765           result.push_back(s[0]);
766           result.push_back(s[1]);
767           ++i;
768           continue;
769         } else if (s[0] == '\"') {
770           state = State::None;
771         }
772         result.push_back(s[0]);
773         break;
774       case State::InlineComment:
775         if (s.startsWith("*/")) {
776           state = State::None;
777           ++i;
778         }
779         break;
780       case State::LineComment:
781         if (s[0] == '\n') {
782           // skip the line break. It doesn't matter.
783           state = State::None;
784         }
785         break;
786       default:
787         throw std::logic_error("Unknown comment state");
788     }
789   }
790   return result;
791 }
792
793 }
794
795 //////////////////////////////////////////////////////////////////////
796
797 dynamic parseJson(StringPiece range) {
798   return parseJson(range, json::serialization_opts());
799 }
800
801 dynamic parseJson(
802     StringPiece range,
803     json::serialization_opts const& opts) {
804
805   json::Input in(range, &opts);
806
807   auto ret = parseValue(in);
808   in.skipWhitespace();
809   if (in.size() && *in != '\0') {
810     in.error("parsing didn't consume all input");
811   }
812   return ret;
813 }
814
815 std::string toJson(dynamic const& dyn) {
816   return json::serialize(dyn, json::serialization_opts());
817 }
818
819 std::string toPrettyJson(dynamic const& dyn) {
820   json::serialization_opts opts;
821   opts.pretty_formatting = true;
822   return json::serialize(dyn, opts);
823 }
824
825 //////////////////////////////////////////////////////////////////////
826 // dynamic::print_as_pseudo_json() is implemented here for header
827 // ordering reasons (most of the dynamic implementation is in
828 // dynamic-inl.h, which we don't want to include json.h).
829
830 void dynamic::print_as_pseudo_json(std::ostream& out) const {
831   json::serialization_opts opts;
832   opts.allow_non_string_keys = true;
833   opts.allow_nan_inf = true;
834   out << json::serialize(*this, opts);
835 }
836
837 void PrintTo(const dynamic& dyn, std::ostream* os) {
838   json::serialization_opts opts;
839   opts.allow_nan_inf = true;
840   opts.allow_non_string_keys = true;
841   opts.pretty_formatting = true;
842   opts.sort_keys = true;
843   *os << json::serialize(dyn, opts);
844 }
845
846 //////////////////////////////////////////////////////////////////////
847
848 }