json.hpp

Go to the documentation of this file.

#pragma once
#include <fc/variant.hpp>
#include <fc/filesystem.hpp>
#include <fc/time.hpp>
#include <fc/utility.hpp>
#include <fc/exception/exception.hpp>
 
#define DEFAULT_MAX_RECURSION_DEPTH 200
 
namespace fc
{
   using std::ostream;
 
   class json
   {
      public:
         enum class parse_type : unsigned char
         {
            legacy_parser         = 0,
            strict_parser         = 1,
            relaxed_parser        = 2,
            legacy_parser_with_string_doubles = 3
         };
         enum class output_formatting : unsigned char
         {
            stringify_large_ints_and_doubles = 0,
            legacy_generator = 1
         };
         using yield_function_t = fc::optional_delegate<void(size_t)>;
         static constexpr uint64_t max_length_limit = std::numeric_limits<uint64_t>::max();
         static constexpr size_t escape_string_yield_check_count = 128;
         static variant  from_string( const string& utf8_str, const parse_type ptype = parse_type::legacy_parser, uint32_t max_depth = DEFAULT_MAX_RECURSION_DEPTH );
         static variants variants_from_string( const string& utf8_str, const parse_type ptype = parse_type::legacy_parser, uint32_t max_depth = DEFAULT_MAX_RECURSION_DEPTH );
         static string   to_string( const variant& v, const yield_function_t& yield, const output_formatting format = output_formatting::stringify_large_ints_and_doubles);
         static string   to_pretty_string( const variant& v, const yield_function_t& yield, const output_formatting format = output_formatting::stringify_large_ints_and_doubles );
 
         static bool     is_valid( const std::string& json_str, const parse_type ptype = parse_type::legacy_parser, const uint32_t max_depth = DEFAULT_MAX_RECURSION_DEPTH );
 
         template<typename T>
         static bool     save_to_file( const T& v, const fc::path& fi, const bool pretty = true, const output_formatting format = output_formatting::stringify_large_ints_and_doubles )
         {
            return save_to_file( variant(v), fi, pretty, format );
         }
 
         static bool     save_to_file( const variant& v, const fc::path& fi, const bool pretty = true, const output_formatting format = output_formatting::stringify_large_ints_and_doubles );
         static variant  from_file( const fc::path& p, const parse_type ptype = parse_type::legacy_parser, const uint32_t max_depth = DEFAULT_MAX_RECURSION_DEPTH );
 
         template<typename T>
         static T from_file( const fc::path& p, const parse_type ptype = parse_type::legacy_parser, const uint32_t max_depth = DEFAULT_MAX_RECURSION_DEPTH )
         {
            return json::from_file(p, ptype, max_depth).as<T>();
         }
 
         template<typename T>
         static string   to_string( const T& v, const fc::time_point& deadline, const output_formatting format = output_formatting::stringify_large_ints_and_doubles, const uint64_t max_len = max_length_limit )
         {
            const auto yield = [&](size_t s) {
               FC_CHECK_DEADLINE(deadline);
               FC_ASSERT(s <= max_len);
            };
            return to_string( variant(v), yield, format );
         }
 
         template<typename T>
         static string   to_pretty_string( const T& v, const fc::time_point& deadline = fc::time_point::maximum(), const output_formatting format = output_formatting::stringify_large_ints_and_doubles, const uint64_t max_len = max_length_limit )
         {
            const auto yield = [&](size_t s) {
               FC_CHECK_DEADLINE(deadline);
               FC_ASSERT( s <= max_len );
            };
            return to_pretty_string( variant(v), yield, format );
         }
 
         template<typename T>
         static bool save_to_file( const T& v, const std::string& p, const bool pretty = true, const output_formatting format = output_formatting::stringify_large_ints_and_doubles )
         {
            return save_to_file( variant(v), fc::path(p), pretty, format );
         }
   };
 
   std::string escape_string( const std::string_view& str, const json::yield_function_t& yield, bool escape_control_chars = true );
 
} // fc
 
#undef DEFAULT_MAX_RECURSION_DEPTH