From 161c74a92ed97f163a3842ba6ed08a1b6d2d3995 Mon Sep 17 00:00:00 2001 From: Niels Date: Thu, 28 Jul 2016 21:19:56 +0200 Subject: [PATCH] some cleanup --- src/json.hpp | 19 +++++++++++++++++-- src/json.hpp.re2c | 28 +++++++++++++++++++++++++--- 2 files changed, 42 insertions(+), 5 deletions(-) diff --git a/src/json.hpp b/src/json.hpp index 15221b8be..f4c1b0f5e 100644 --- a/src/json.hpp +++ b/src/json.hpp @@ -760,6 +760,7 @@ class basic_json }; std::unique_ptr object(alloc.allocate(1), deleter); alloc.construct(object.get(), std::forward(args)...); + assert(object.get() != nullptr); return object.release(); } @@ -4597,6 +4598,10 @@ class basic_json object | result of function `object_t::empty()` array | result of function `array_t::empty()` + @note This function does not return whether a string stored as JSON value + is empty - it returns whether the JSON container itself is empty which is + false in the case of a string. + @complexity Constant, as long as @ref array_t and @ref object_t satisfy the Container concept; that is, their `empty()` functions have constant complexity. @@ -4626,12 +4631,14 @@ class basic_json case value_t::array: { + // delegate call to array_t::empty() assert(m_value.array != nullptr); return m_value.array->empty(); } case value_t::object: { + // delegate call to object_t::empty() assert(m_value.object != nullptr); return m_value.object->empty(); } @@ -4660,6 +4667,10 @@ class basic_json object | result of function object_t::size() array | result of function array_t::size() + @note This function does not return the length of a string stored as JSON + value - it returns the number of elements in the JSON value which is 1 in + the case of a string. + @complexity Constant, as long as @ref array_t and @ref object_t satisfy the Container concept; that is, their size() functions have constant complexity. @@ -4690,12 +4701,14 @@ class basic_json case value_t::array: { + // delegate call to array_t::size() assert(m_value.array != nullptr); return m_value.array->size(); } case value_t::object: { + // delegate call to object_t::size() assert(m_value.object != nullptr); return m_value.object->size(); } @@ -4750,12 +4763,14 @@ class basic_json { case value_t::array: { + // delegate call to array_t::max_size() assert(m_value.array != nullptr); return m_value.array->max_size(); } case value_t::object: { + // delegate call to object_t::max_size() assert(m_value.object != nullptr); return m_value.object->max_size(); } @@ -5844,14 +5859,14 @@ class basic_json // string->float->string, string->double->string or string->long // double->string; to be safe, we read this value from // std::numeric_limits::digits10 - const auto old_preicison = o.precision(std::numeric_limits::digits10); + const auto old_precision = o.precision(std::numeric_limits::digits10); // do the actual serialization j.dump(o, pretty_print, static_cast(indentation)); // reset locale and precision o.imbue(old_locale); - o.precision(old_preicison); + o.precision(old_precision); return o; } diff --git a/src/json.hpp.re2c b/src/json.hpp.re2c index 74db214eb..d7b197937 100644 --- a/src/json.hpp.re2c +++ b/src/json.hpp.re2c @@ -760,6 +760,7 @@ class basic_json }; std::unique_ptr object(alloc.allocate(1), deleter); alloc.construct(object.get(), std::forward(args)...); + assert(object.get() != nullptr); return object.release(); } @@ -4597,6 +4598,10 @@ class basic_json object | result of function `object_t::empty()` array | result of function `array_t::empty()` + @note This function does not return whether a string stored as JSON value + is empty - it returns whether the JSON container itself is empty which is + false in the case of a string. + @complexity Constant, as long as @ref array_t and @ref object_t satisfy the Container concept; that is, their `empty()` functions have constant complexity. @@ -4626,12 +4631,14 @@ class basic_json case value_t::array: { + // delegate call to array_t::empty() assert(m_value.array != nullptr); return m_value.array->empty(); } case value_t::object: { + // delegate call to object_t::empty() assert(m_value.object != nullptr); return m_value.object->empty(); } @@ -4660,6 +4667,10 @@ class basic_json object | result of function object_t::size() array | result of function array_t::size() + @note This function does not return the length of a string stored as JSON + value - it returns the number of elements in the JSON value which is 1 in + the case of a string. + @complexity Constant, as long as @ref array_t and @ref object_t satisfy the Container concept; that is, their size() functions have constant complexity. @@ -4690,12 +4701,14 @@ class basic_json case value_t::array: { + // delegate call to array_t::size() assert(m_value.array != nullptr); return m_value.array->size(); } case value_t::object: { + // delegate call to object_t::size() assert(m_value.object != nullptr); return m_value.object->size(); } @@ -4750,12 +4763,14 @@ class basic_json { case value_t::array: { + // delegate call to array_t::max_size() assert(m_value.array != nullptr); return m_value.array->max_size(); } case value_t::object: { + // delegate call to object_t::max_size() assert(m_value.object != nullptr); return m_value.object->max_size(); } @@ -5844,14 +5859,14 @@ class basic_json // string->float->string, string->double->string or string->long // double->string; to be safe, we read this value from // std::numeric_limits::digits10 - const auto old_preicison = o.precision(std::numeric_limits::digits10); + const auto old_precision = o.precision(std::numeric_limits::digits10); // do the actual serialization j.dump(o, pretty_print, static_cast(indentation)); // reset locale and precision o.imbue(old_locale); - o.precision(old_preicison); + o.precision(old_precision); return o; } @@ -9560,7 +9575,7 @@ struct hash @brief user-defined string literal for JSON values This operator implements a user-defined string literal for JSON objects. It -can be used by adding \p "_json" to a string literal and returns a JSON object +can be used by adding `"_json"` to a string literal and returns a JSON object if no parse error occurred. @param[in] s a string representation of a JSON object @@ -9576,6 +9591,13 @@ inline nlohmann::json operator "" _json(const char* s, std::size_t) /*! @brief user-defined string literal for JSON pointer +This operator implements a user-defined string literal for JSON Pointers. It +can be used by adding `"_json"` to a string literal and returns a JSON pointer +object if no parse error occurred. + +@param[in] s a string representation of a JSON Pointer +@return a JSON pointer object + @since version 2.0.0 */ inline nlohmann::json::json_pointer operator "" _json_pointer(const char* s, std::size_t) -- GitLab