// Copyright Benoit Blanchon 2014-2016 // MIT License // // Arduino JSON library // https://github.com/bblanchon/ArduinoJson // If you like this project, please add a star! #pragma once #include "Internals/JsonBufferAllocated.hpp" #include "Internals/JsonPrintable.hpp" #include "Internals/List.hpp" #include "Internals/ReferenceType.hpp" #include "Internals/StringFuncs.hpp" #include "Internals/ValueSetter.hpp" #include "JsonVariant.hpp" #include "TypeTraits/ConstRefOrConstPtr.hpp" #include "TypeTraits/EnableIf.hpp" #include "TypeTraits/IsFloatingPoint.hpp" #include "TypeTraits/IsSame.hpp" // Returns the size (in bytes) of an array with n elements. // Can be very handy to determine the size of a StaticJsonBuffer. #define JSON_ARRAY_SIZE(NUMBER_OF_ELEMENTS) \ (sizeof(JsonArray) + (NUMBER_OF_ELEMENTS) * sizeof(JsonArray::node_type)) namespace ArduinoJson { // Forward declarations class JsonObject; class JsonBuffer; class JsonArraySubscript; // An array of JsonVariant. // // The constructor is private, instances must be created via // JsonBuffer::createArray() or JsonBuffer::parseArray(). // A JsonArray can be serialized to a JSON string via JsonArray::printTo(). // It can also be deserialized from a JSON string via JsonBuffer::parseArray(). class JsonArray : public Internals::JsonPrintable, public Internals::ReferenceType, public Internals::List, public Internals::JsonBufferAllocated { public: // Create an empty JsonArray attached to the specified JsonBuffer. // You should not call this constructor directly. // Instead, use JsonBuffer::createArray() or JsonBuffer::parseArray(). explicit JsonArray(JsonBuffer *buffer) : Internals::List(buffer) {} // Gets the value at the specified index JsonVariant operator[](size_t index) const { return get(index); } // Gets or sets the value at specified index JsonArraySubscript operator[](size_t index); // Adds the specified value at the end of the array. // // bool add(bool); // bool add(char); // bool add(long); // bool add(int); // bool add(short); // bool add(float value); // bool add(double value); // bool add(const char*); // bool add(const char[]); // bool add(const char[N]); // bool add(RawJson); // bool add(const std::string&) // bool add(const String&) // bool add(const JsonVariant&); // bool add(JsonArray&); // bool add(JsonObject&); template bool add(const T &value) { // reduce the number of template function instanciation to reduce code size return addNodeImpl::type>(value); } // bool add(float value, uint8_t decimals); // bool add(double value, uint8_t decimals); template bool add(T value, uint8_t decimals) { return add(JsonVariant(value, decimals)); } // Sets the value at specified index. // // bool set(size_t index, bool value); // bool set(size_t index, long value); // bool set(size_t index, int value); // bool set(size_t index, short value); // bool set(size_t index, const std::string&) // bool set(size_t index, const String&) // bool set(size_t index, const JsonVariant&); // bool set(size_t index, JsonArray&); // bool set(size_t index, JsonObject&); template bool set(size_t index, const T &value) { // reduce the number of template function instanciation to reduce code size return setNodeAt::type>(index, value); } // bool set(size_t index, float value, uint8_t decimals = 2); // bool set(size_t index, double value, uint8_t decimals = 2); template typename TypeTraits::EnableIf::value, bool>::type set(size_t index, T value, uint8_t decimals) { return set(index, JsonVariant(value, decimals)); } // Gets the value at the specified index. template typename Internals::JsonVariantAs::type get(size_t index) const { node_type *node = getNodeAt(index); return node ? node->content.as() : Internals::JsonVariantDefault::get(); ; } // Check the type of the value at specified index. template bool is(size_t index) const { node_type *node = getNodeAt(index); return node ? node->content.is() : false; } // Creates a JsonArray and adds a reference at the end of the array. // It's a shortcut for JsonBuffer::createArray() and JsonArray::add() JsonArray &createNestedArray(); // Creates a JsonObject and adds a reference at the end of the array. // It's a shortcut for JsonBuffer::createObject() and JsonArray::add() JsonObject &createNestedObject(); // Removes element at specified index. void removeAt(size_t index) { removeNode(getNodeAt(index)); } // Returns a reference an invalid JsonArray. // This object is meant to replace a NULL pointer. // This is used when memory allocation or JSON parsing fail. static JsonArray &invalid() { static JsonArray instance(NULL); return instance; } // Imports a 1D array template bool copyFrom(T (&array)[N]) { return copyFrom(array, N); } // Imports a 1D array template bool copyFrom(T *array, size_t len) { bool ok = true; for (size_t i = 0; i < len; i++) { ok &= add(array[i]); } return ok; } // Imports a 2D array template bool copyFrom(T (&array)[N1][N2]) { bool ok = true; for (size_t i = 0; i < N1; i++) { JsonArray &nestedArray = createNestedArray(); for (size_t j = 0; j < N2; j++) { ok &= nestedArray.add(array[i][j]); } } return ok; } // Exports a 1D array template size_t copyTo(T (&array)[N]) const { return copyTo(array, N); } // Exports a 1D array template size_t copyTo(T *array, size_t len) const { size_t i = 0; for (const_iterator it = begin(); it != end() && i < len; ++it) array[i++] = *it; return i; } // Exports a 2D array template void copyTo(T (&array)[N1][N2]) const { size_t i = 0; for (const_iterator it = begin(); it != end() && i < N1; ++it) { it->asArray().copyTo(array[i++]); } } private: node_type *getNodeAt(size_t index) const { node_type *node = _firstNode; while (node && index--) node = node->next; return node; } template bool setNodeAt(size_t index, TValueRef value) { node_type *node = getNodeAt(index); if (!node) return false; return Internals::ValueSetter::set(_buffer, node->content, value); } template bool addNodeImpl(TValueRef value) { node_type *node = addNewNode(); if (!node) return false; return Internals::ValueSetter::set(_buffer, node->content, value); } }; namespace Internals { template <> struct JsonVariantDefault { static JsonArray &get() { return JsonArray::invalid(); } }; } }