History

arendst 299bed1c05 v5.9.1f - Update libraries and a fix 5.9.1f * Upgrade library ArduinoJson to 5.11.2 * Upgrade library IRRemoteEsp8266 to 2.2.1 + 2 commits but tweaked some protocols to keep code usage small * Upgrade library NeoPixelBus to 2.2.9 * Upgrade library OneWire to 2.3.3 + 6 commits * Formalize library PubSubClient to 2.6 + 9 commits and additional delay * Add optional ADS1115 driver as alternative for unsupported I2Cdevlib in esp8266-core 2.4.0-rc2 * Fix wrong response name for command HlwISet (#1214)		2017-11-19 18:02:03 +01:00
..
examples	v5.9.1f - Update libraries and a fix	2017-11-19 18:02:03 +01:00
src	v5.9.1f - Update libraries and a fix	2017-11-19 18:02:03 +01:00
ArduinoJson.h	v5.9.1f - Update libraries and a fix	2017-11-19 18:02:03 +01:00
CHANGELOG.md	v5.9.1f - Update libraries and a fix	2017-11-19 18:02:03 +01:00
LICENSE.md	v5.9.1f - Update libraries and a fix	2017-11-19 18:02:03 +01:00
README.md	v5.9.1f - Update libraries and a fix	2017-11-19 18:02:03 +01:00
keywords.txt	v5.9.1f - Update libraries and a fix	2017-11-19 18:02:03 +01:00
library.properties	v5.9.1f - Update libraries and a fix	2017-11-19 18:02:03 +01:00

README.md

ArduinoJson - C++ JSON library for IoT

An elegant and efficient JSON library for embedded systems.

It's designed to have the most intuitive API, the smallest footprint and is able to work without any allocation on the heap (no malloc).

It has been written with Arduino in mind, but it isn't linked to Arduino libraries so you can use this library in any other C++ project. For instance, it supports Aduino's String and Stream, but also std::string, std::istream and std::ostream.

Features

JSON decoding (comments are supported)
JSON encoding (with optional indentation)
Elegant API, very easy to use
Fixed memory allocation (zero malloc)
No data duplication (zero copy)
Portable (written in C++98)
Self-contained (no external dependency)
Small footprint
Header-only library
MIT License

Works on

Arduino boards: Uno, Due, Mini, Micro, Yun...
ESP8266, ESP32
Teensy
RedBearLab boards (BLE Nano...)
Intel Edison and Galileo
WeMos boards: D1...
Computers: Windows, Linux, OSX...
PlatformIO
Particle
Energia

Quick start

Decoding / Parsing

char json[] = "{\"sensor\":\"gps\",\"time\":1351824120,\"data\":[48.756080,2.302038]}";

StaticJsonBuffer<200> jsonBuffer;

JsonObject& root = jsonBuffer.parseObject(json);

const char* sensor = root["sensor"];
long time          = root["time"];
double latitude    = root["data"][0];
double longitude   = root["data"][1];

See JsonParserExample.ino

Use ArduinoJson Assistant to compute the buffer size.

Encoding / Generating

StaticJsonBuffer<200> jsonBuffer;

JsonObject& root = jsonBuffer.createObject();
root["sensor"] = "gps";
root["time"] = 1351824120;

JsonArray& data = root.createNestedArray("data");
data.add(48.756080);
data.add(2.302038);

root.printTo(Serial);
// This prints:
// {"sensor":"gps","time":1351824120,"data":[48.756080,2.302038]}