// Copyright Benoit Blanchon 2014-2017 // MIT License // // Arduino JSON library // https://github.com/bblanchon/ArduinoJson // If you like this project, please add a star! #pragma once #include #include // for uint8_t #include "Data/JsonVariantContent.hpp" #include "Data/JsonVariantDefault.hpp" #include "Data/JsonVariantType.hpp" #include "JsonVariantBase.hpp" #include "RawJson.hpp" #include "Serialization/JsonPrintable.hpp" #include "TypeTraits/EnableIf.hpp" #include "TypeTraits/IsFloatingPoint.hpp" #include "TypeTraits/IsIntegral.hpp" #include "TypeTraits/IsSame.hpp" #include "TypeTraits/IsSignedIntegral.hpp" #include "TypeTraits/IsUnsignedIntegral.hpp" #include "TypeTraits/RemoveConst.hpp" #include "TypeTraits/RemoveReference.hpp" namespace ArduinoJson { // Forward declarations. class JsonArray; class JsonObject; // A variant that can be a any value serializable to a JSON value. // // It can be set to: // - a boolean // - a char, short, int or a long (signed or unsigned) // - a string (const char*) // - a reference to a JsonArray or JsonObject class JsonVariant : public JsonVariantBase { friend void Internals::JsonSerializer::serialize(const JsonVariant &, JsonWriter &); public: // Creates an uninitialized JsonVariant JsonVariant() : _type(Internals::JSON_UNDEFINED) {} // Create a JsonVariant containing a boolean value. // It will be serialized as "true" or "false" in JSON. JsonVariant(bool value) { using namespace Internals; _type = JSON_BOOLEAN; _content.asInteger = static_cast(value); } // Create a JsonVariant containing a floating point value. // The second argument specifies the number of decimal digits to write in // the JSON string. // JsonVariant(double value, uint8_t decimals); // JsonVariant(float value, uint8_t decimals); template JsonVariant(T value, uint8_t decimals = 2, typename TypeTraits::EnableIf< TypeTraits::IsFloatingPoint::value>::type * = 0) { using namespace Internals; _type = static_cast(JSON_FLOAT_0_DECIMALS + decimals); _content.asFloat = static_cast(value); } // Create a JsonVariant containing an integer value. // JsonVariant(signed short) // JsonVariant(signed int) // JsonVariant(signed long) template JsonVariant(T value, typename TypeTraits::EnableIf< TypeTraits::IsSignedIntegral::value>::type * = 0) { using namespace Internals; if (value >= 0) { _type = JSON_POSITIVE_INTEGER; _content.asInteger = static_cast(value); } else { _type = JSON_NEGATIVE_INTEGER; _content.asInteger = static_cast(-value); } } // JsonVariant(unsigned short) // JsonVariant(unsigned int) // JsonVariant(unsigned long) template JsonVariant(T value, typename TypeTraits::EnableIf< TypeTraits::IsUnsignedIntegral::value>::type * = 0) { using namespace Internals; _type = JSON_POSITIVE_INTEGER; _content.asInteger = static_cast(value); } // Create a JsonVariant containing a string. JsonVariant(const char *value) { _type = Internals::JSON_STRING; _content.asString = value; } // Create a JsonVariant containing an unparsed string JsonVariant(RawJson value) { _type = Internals::JSON_UNPARSED; _content.asString = value; } // Create a JsonVariant containing a reference to an array. // CAUTION: we are lying about constness, because the array can be modified if // the variant is converted back to a JsonArray& JsonVariant(const JsonArray &array); // Create a JsonVariant containing a reference to an object. // CAUTION: we are lying about constness, because the object can be modified // if the variant is converted back to a JsonObject& JsonVariant(const JsonObject &object); // Get the variant as the specified type. // // short as() const; // int as() const; // long as() const; template const typename TypeTraits::EnableIf::value, T>::type as() const { return static_cast(asInteger()); } // // short as() const; // int as() const; // long as() const; template const typename TypeTraits::EnableIf::value, T>::type as() const { return static_cast(asUnsignedInteger()); } // // double as() const; // float as() const; template const typename TypeTraits::EnableIf::value, T>::type as() const { return static_cast(asFloat()); } // // const char* as() const; // const char* as() const; template typename TypeTraits::EnableIf::value || TypeTraits::IsSame::value, const char *>::type as() const { return asString(); } // // std::string as() const; // String as() const; template typename TypeTraits::EnableIf::has_append, T>::type as() const { const char *cstr = asString(); if (cstr) return T(cstr); T s; printTo(s); return s; } // // const bool as() const template const typename TypeTraits::EnableIf::value, T>::type as() const { return asInteger() != 0; } // // JsonArray& as const; // JsonArray& as const; template typename TypeTraits::EnableIf< TypeTraits::IsSame::type, JsonArray>::value, JsonArray &>::type as() const { return asArray(); } // // const JsonArray& as const; template typename TypeTraits::EnableIf< TypeTraits::IsSame::type, const JsonArray>::value, const JsonArray &>::type as() const { return asArray(); } // // JsonObject& as const; // JsonObject& as const; template typename TypeTraits::EnableIf< TypeTraits::IsSame::type, JsonObject>::value, JsonObject &>::type as() const { return asObject(); } // // JsonObject& as const; // JsonObject& as const; template typename TypeTraits::EnableIf< TypeTraits::IsSame::type, const JsonObject>::value, const JsonObject &>::type as() const { return asObject(); } // // JsonVariant as const; template typename TypeTraits::EnableIf::value, T>::type as() const { return *this; } // Tells weither the variant has the specified type. // Returns true if the variant has type type T, false otherwise. // // short as() const; // int as() const; // long as() const; template const typename TypeTraits::EnableIf::value && !TypeTraits::IsSame::value, bool>::type is() const { return isInteger(); } // // double is() const; // float is() const; template const typename TypeTraits::EnableIf::value, bool>::type is() const { return isFloat(); } // // const bool is() const template const typename TypeTraits::EnableIf::value, bool>::type is() const { return isBoolean(); } // // bool is() const; // bool is() const; template typename TypeTraits::EnableIf::value || TypeTraits::IsSame::value, bool>::type is() const { return isString(); } // // bool is const; // bool is const; // bool is const; template typename TypeTraits::EnableIf< TypeTraits::IsSame< typename TypeTraits::RemoveConst< typename TypeTraits::RemoveReference::type>::type, JsonArray>::value, bool>::type is() const { return isArray(); } // // bool is const; // bool is const; // bool is const; template typename TypeTraits::EnableIf< TypeTraits::IsSame< typename TypeTraits::RemoveConst< typename TypeTraits::RemoveReference::type>::type, JsonObject>::value, bool>::type is() const { return isObject(); } // Returns true if the variant has a value bool success() const { return _type != Internals::JSON_UNDEFINED; } // DEPRECATED: use as() instead const char *asString() const; // DEPRECATED: use as() instead JsonArray &asArray() const; // DEPRECATED: use as() instead JsonObject &asObject() const; private: // It's not allowed to store a char template JsonVariant(T value, typename TypeTraits::EnableIf< TypeTraits::IsSame::value>::type * = 0); Internals::JsonFloat asFloat() const; Internals::JsonInteger asInteger() const; Internals::JsonUInt asUnsignedInteger() const; bool isBoolean() const; bool isFloat() const; bool isInteger() const; bool isArray() const { return _type == Internals::JSON_ARRAY; } bool isObject() const { return _type == Internals::JSON_OBJECT; } bool isString() const { return _type == Internals::JSON_STRING || (_type == Internals::JSON_UNPARSED && _content.asString && !strcmp("null", _content.asString)); } // The current type of the variant Internals::JsonVariantType _type; // The various alternatives for the value of the variant. Internals::JsonVariantContent _content; }; inline JsonVariant float_with_n_digits(float value, uint8_t digits) { return JsonVariant(value, digits); } inline JsonVariant double_with_n_digits(double value, uint8_t digits) { return JsonVariant(value, digits); } }