C++ Shell CMake Other
Permalink
Failed to load latest commit information.
.github Changed all link to point to HTTPS version Dec 11, 2017
examples `RawJson()` accepts any kind of string and obeys to duplication rules Jan 18, 2018
fuzzing Added fuzzing to travis Jun 6, 2018
scripts Added fuzzing to travis Jun 6, 2018
src Fixed `JsonVariant::is<int>()` that returned true for empty strings Jul 5, 2018
test Fixed `JsonVariant::is<int>()` that returned true for empty strings Jul 5, 2018
third-party/catch Set copyright year to 2018 Jan 5, 2018
.clang-format ArduinoJson is now a header-only library (issue #199) Jun 22, 2016
.gitattributes Fixed segmentation fault in `DynamicJsonBuffer` when memory allocatio… Aug 1, 2015
.gitignore Added fuzzer Jan 8, 2017
.mbedignore Added fuzzing/ to .mbedignore Jan 25, 2017
.travis.yml Added fuzzing to travis Jun 6, 2018
ArduinoJson.h Set copyright year to 2018 Jan 5, 2018
CHANGELOG.md Fixed `JsonVariant::is<int>()` that returned true for empty strings Jul 5, 2018
CMakeLists.txt Set copyright year to 2018 Jan 5, 2018
CONTRIBUTING.md Split CONTRIBUTING and SUPPORT Oct 3, 2017
LICENSE.md Set copyright year to 2018 Jan 5, 2018
README.md Added campaign information in links Jan 15, 2018
SUPPORT.md Added campaign information in links Jan 15, 2018
appveyor.yml Set version to 5.13.2 Jun 1, 2018
banner.svg Added banner with the new logo Oct 16, 2017
keywords.txt Added DynamicJsonBuffer to the keywords Nov 23, 2016
library.json Set version to 5.13.2 Jun 1, 2018
library.properties Set version to 5.13.2 Jun 1, 2018

README.md

ArduinoJson


Build status Build Status Coverage Status Star this project

ArduinoJson is a C++ JSON library for Arduino and IoT (Internet Of Things).

Features

  • JSON decoding (comments are supported)
  • JSON encoding (with optional indentation)
  • Elegant API, easy to use
  • Fixed memory allocation (zero malloc)
  • No data duplication (zero copy)
  • Portable (written in C++98, can be used in any C++ project)
  • Self-contained (no external dependency)
  • Small footprint
  • Input and output streams
  • 100% code coverage
  • Header-only library
  • MIT License
  • Comprehensive documentation

Compatibility

ArduinoJson works on the following hardware:

ArduinoJson compiles with zero warning on the following compilers, IDEs, and platforms:

Quickstart

Deserialization

Here is a program that parses a JSON document with ArduinoJson.

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 the tutorial on arduinojson.org

Serialization

Here is a program that generates a JSON document with ArduinoJson:

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]}

See the tutorial on arduinojson.org

Documentation

The documentation is available on arduinojson.org, here are some shortcuts:

  • The Examples show how to use the library in various situations.
  • The API Reference contains the description of each class and function.
  • The FAQ has the answer to virtually every question.
  • The ArduinoJson Assistant writes programs for you!

Do you like this library? Please star this project on GitHub!

What? You don't like it but you love it? We don't take donations anymore, but we sell a book, so you can help and learn at the same time!