X-Git-Url: http://plrg.eecs.uci.edu/git/?p=folly.git;a=blobdiff_plain;f=folly%2Fjson.h;h=788587a8aa6defbabf2b8ef69b91f07f5ceee278;hp=11024281ecdf83ec13a45da1e2182df3546339b9;hb=5cef863eee8a03e1b6b137fb283d6fe703f35d2d;hpb=dc64a0e38329a177c8ea910f49bb0418c47dafd4 diff --git a/folly/json.h b/folly/json.h index 11024281..788587a8 100644 --- a/folly/json.h +++ b/folly/json.h @@ -1,5 +1,5 @@ /* - * Copyright 2013 Facebook, Inc. + * Copyright 2017 Facebook, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -38,12 +38,14 @@ * @author Jordan DeLong */ -#ifndef FOLLY_JSON_H_ -#define FOLLY_JSON_H_ +#pragma once -#include "folly/dynamic.h" -#include "folly/FBString.h" -#include "folly/Range.h" +#include +#include + +#include +#include +#include namespace folly { @@ -53,12 +55,20 @@ namespace json { struct serialization_opts { explicit serialization_opts() - : allow_non_string_keys(false) - , javascript_safe(false) - , pretty_formatting(false) - , encode_non_ascii(false) - , validate_utf8(false) - {} + : allow_non_string_keys(false), + javascript_safe(false), + pretty_formatting(false), + encode_non_ascii(false), + validate_utf8(false), + allow_trailing_comma(false), + sort_keys(false), + skip_invalid_utf8(false), + allow_nan_inf(false), + double_mode(double_conversion::DoubleToStringConverter::SHORTEST), + double_num_digits(0), // ignored when mode is SHORTEST + double_fallback(false), + parse_numbers_as_strings(false), + recursion_limit(100) {} // If true, keys in an object can be non-strings. (In strict // JSON, object keys must be strings.) This is used by dynamic's @@ -81,6 +91,40 @@ namespace json { // Check that strings are valid utf8 bool validate_utf8; + + // Allow trailing comma in lists of values / items + bool allow_trailing_comma; + + // Sort keys of all objects before printing out (potentially slow) + // using dynamic::operator<. + // Has no effect if sort_keys_by is set. + bool sort_keys; + + // Sort keys of all objects before printing out (potentially slow) + // using the provided less functor. + Function sort_keys_by; + + // Replace invalid utf8 characters with U+FFFD and continue + bool skip_invalid_utf8; + + // true to allow NaN or INF values + bool allow_nan_inf; + + // Options for how to print floating point values. See Conv.h + // toAppend implementation for floating point for more info + double_conversion::DoubleToStringConverter::DtoaMode double_mode; + unsigned int double_num_digits; + + // Fallback to double when a value that looks like integer is too big to + // fit in an int64_t. Can result in loss a of precision. + bool double_fallback; + + // Do not parse numbers. Instead, store them as strings and leave the + // conversion up to the user. + bool parse_numbers_as_strings; + + // Recursion limit when parsing. + unsigned int recursion_limit; }; /* @@ -88,16 +132,22 @@ namespace json { * For the most common use cases there are simpler functions in the * main folly namespace below. */ - fbstring serialize(dynamic const&, serialization_opts const&); + std::string serialize(dynamic const&, serialization_opts const&); /* * Escape a string so that it is legal to print it in JSON text and * append the result to out. */ - void escapeString(StringPiece input, - fbstring& out, - const serialization_opts& opts); + void escapeString( + StringPiece input, + std::string& out, + const serialization_opts& opts); + + /* + * Strip all C99-like comments (i.e. // and / * ... * /) + */ + std::string stripComments(StringPiece jsonC); } ////////////////////////////////////////////////////////////////////// @@ -106,21 +156,25 @@ namespace json { * Parse a json blob out of a range and produce a dynamic representing * it. */ +dynamic parseJson(StringPiece, json::serialization_opts const&); dynamic parseJson(StringPiece); /* * Serialize a dynamic into a json string. */ -fbstring toJson(dynamic const&); +std::string toJson(dynamic const&); /* * Same as the above, except format the json with some minimal * indentation. */ -fbstring toPrettyJson(dynamic const&); +std::string toPrettyJson(dynamic const&); +/* + * Printer for GTest. + * Uppercase name to fill GTest's API, which calls this method through ADL. + */ +void PrintTo(const dynamic&, std::ostream*); ////////////////////////////////////////////////////////////////////// } - -#endif