mirror of
https://github.com/eledio-devices/thirdparty-ArduinoJson.git
synced 2025-10-31 16:14:11 +01:00
aa2ef79e55
* Removed `ArduinoJson::String` * Removed `JsonVariant::defaultValue<T>()` * Removed non-template `JsonObject::get()` and `JsonArray.get()` * Fixed support for `StringSumHelper` (issue #184) * Replaced `ARDUINOJSON_USE_ARDUINO_STRING` by `ARDUINOJSON_ENABLE_STD_STRING` and `ARDUINOJSON_ENABLE_ARDUINO_STRING` (issue #378) * Added example `StringExample.ino` to show where `String` can be used
136 lines
4.1 KiB
C++
136 lines
4.1 KiB
C++
// 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 <stddef.h> // for size_t
|
|
#include <stdint.h> // for uint8_t
|
|
#include <string.h>
|
|
|
|
#include "JsonVariant.hpp"
|
|
|
|
#if defined(__clang__)
|
|
#pragma clang diagnostic push
|
|
#pragma clang diagnostic ignored "-Wnon-virtual-dtor"
|
|
#elif defined(__GNUC__)
|
|
#if __GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 6)
|
|
#pragma GCC diagnostic push
|
|
#endif
|
|
#pragma GCC diagnostic ignored "-Wnon-virtual-dtor"
|
|
#endif
|
|
|
|
namespace ArduinoJson {
|
|
class JsonArray;
|
|
class JsonObject;
|
|
|
|
// Entry point for using the library.
|
|
//
|
|
// Handle the memory management (done in derived classes) and calls the parser.
|
|
// This abstract class is implemented by StaticJsonBuffer which implements a
|
|
// fixed memory allocation.
|
|
class JsonBuffer {
|
|
public:
|
|
// CAUTION: NO VIRTUAL DESTRUCTOR!
|
|
// If we add a virtual constructor the Arduino compiler will add malloc() and
|
|
// free() to the binary, adding 706 useless bytes.
|
|
// virtual ~JsonBuffer() {}
|
|
|
|
// Allocates an empty JsonArray.
|
|
//
|
|
// Returns a reference to the new JsonArray or JsonArray::invalid() if the
|
|
// allocation fails.
|
|
JsonArray &createArray();
|
|
|
|
// Allocates an empty JsonObject.
|
|
//
|
|
// Returns a reference to the new JsonObject or JsonObject::invalid() if the
|
|
// allocation fails.
|
|
JsonObject &createObject();
|
|
|
|
// Allocates and populate a JsonArray from a JSON string.
|
|
//
|
|
// The First argument is a pointer to the JSON string, the memory must be
|
|
// writable
|
|
// because the parser will insert null-terminators and replace escaped chars.
|
|
//
|
|
// The second argument set the nesting limit
|
|
//
|
|
// Returns a reference to the new JsonObject or JsonObject::invalid() if the
|
|
// allocation fails.
|
|
JsonArray &parseArray(
|
|
char *json, uint8_t nestingLimit = ARDUINOJSON_DEFAULT_NESTING_LIMIT);
|
|
|
|
// With this overload, the JsonBuffer will make a copy of the string
|
|
template <typename TString>
|
|
JsonArray &parseArray(const TString &json,
|
|
uint8_t nesting = ARDUINOJSON_DEFAULT_NESTING_LIMIT) {
|
|
return parseArray(strdup(json), nesting);
|
|
}
|
|
|
|
// Allocates and populate a JsonObject from a JSON string.
|
|
//
|
|
// The First argument is a pointer to the JSON string, the memory must be
|
|
// writable
|
|
// because the parser will insert null-terminators and replace escaped chars.
|
|
//
|
|
// The second argument set the nesting limit
|
|
//
|
|
// Returns a reference to the new JsonObject or JsonObject::invalid() if the
|
|
// allocation fails.
|
|
JsonObject &parseObject(
|
|
char *json, uint8_t nestingLimit = ARDUINOJSON_DEFAULT_NESTING_LIMIT);
|
|
|
|
// With this overload, the JsonBuffer will make a copy of the string
|
|
template <typename TString>
|
|
JsonObject &parseObject(const TString &json,
|
|
uint8_t nesting = ARDUINOJSON_DEFAULT_NESTING_LIMIT) {
|
|
return parseObject(strdup(json), nesting);
|
|
}
|
|
|
|
// Generalized version of parseArray() and parseObject(), also works for
|
|
// integral types.
|
|
JsonVariant parse(char *json,
|
|
uint8_t nestingLimit = ARDUINOJSON_DEFAULT_NESTING_LIMIT);
|
|
|
|
// With this overload, the JsonBuffer will make a copy of the string
|
|
template <typename TString>
|
|
JsonVariant parse(const TString &json,
|
|
uint8_t nesting = ARDUINOJSON_DEFAULT_NESTING_LIMIT) {
|
|
return parse(strdup(json), nesting);
|
|
}
|
|
|
|
// Duplicate a string
|
|
template <typename TString>
|
|
char *strdup(const TString &src) {
|
|
return Internals::StringFuncs<TString>::duplicate(src, this);
|
|
}
|
|
|
|
// Allocates n bytes in the JsonBuffer.
|
|
// Return a pointer to the allocated memory or NULL if allocation fails.
|
|
virtual void *alloc(size_t size) = 0;
|
|
|
|
protected:
|
|
// Preserve aligment if nessary
|
|
static FORCE_INLINE size_t round_size_up(size_t bytes) {
|
|
#if ARDUINOJSON_ENABLE_ALIGNMENT
|
|
const size_t x = sizeof(void *) - 1;
|
|
return (bytes + x) & ~x;
|
|
#else
|
|
return bytes;
|
|
#endif
|
|
}
|
|
};
|
|
}
|
|
|
|
#if defined(__clang__)
|
|
#pragma clang diagnostic pop
|
|
#elif defined(__GNUC__)
|
|
#if __GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 6)
|
|
#pragma GCC diagnostic pop
|
|
#endif
|
|
#endif
|