ArduinoJson 6.15.0

📰 Read the complete article on arduinojson.org

Changes since 6.14.1

• Added DeserializationOption::Filter (issue #959)
• Added example JsonFilterExample.ino
• Changed the array subscript operator to automatically add missing elements
• Fixed "deprecated-copy" warning on GCC 9 (fixes #1184)
• Fixed MemberProxy::set(char[]) not duplicating the string (issue #1191)
• Fixed enums serialized as booleans (issue #1197)
• Fixed incorrect string comparison on some platforms (issue #1198)
• Added move-constructor and move-assignment to BasicJsonDocument
• Added BasicJsonDocument::garbageCollect() (issue #1195)
• Added StaticJsonDocument::garbageCollect()
• Changed copy-constructor of BasicJsonDocument to preserve the capacity of the source.
• Removed copy-constructor of JsonDocument (issue #1189)

View version history

BREAKING CHANGES ⚠️

Copy-constructor of BasicJsonDocument

In previous versions, the copy constructor of BasicJsonDocument looked at the source's memoryUsage() to choose its capacity.
Now, the copy constructor of BasicJsonDocument uses the same capacity as the source.
Example:

DynamicJsonDocument doc1(64);
doc1.set(String("example"));
DynamicJsonDocument doc2 = doc1;
Serial.print(doc2.capacity());  // 8 with ArduinoJson 6.14
                                // 64 with ArduinoJson 6.15

I made this change to get consistent results between copy-constructor and move-constructor, and whether RVO applies or not.
If you use the copy-constructor to optimize your documents, you can use garbageCollect() or shrinkToFit() instead.

Copy-constructor of JsonDocument

In previous versions, it was possible to create a function that take a JsonDocument by value.

void myFunction(JsonDocument doc) {}

This function gives the wrong clues because it doesn't receive a copy of the JsonDocument, only a sliced version.
It worked because the copy constructor copied the internal pointers, but it was an accident.
From now, if you need to pass a JsonDocument to a function, you must use a reference:

void myFunction(JsonDocument& doc) {}

How to install

There are several ways to install ArduinoJson, from simpler to more complex:

1. Use the Arduino Library Manager
2. Download ArduinoJson-v6.15.0.h put it in your project folder
3. Download ArduinoJson-v6.15.0.zip and extract it in you libraries folder

Note: ArduinoJson-v6.15.0.h and ArduinoJson-v6.15.0.hpp are almost identical; the difference is that the .hpp keeps everything in the ArduinoJson namespace.

Try online

• JsonGeneratorExample
• JsonParserExample
• MsgPackParserExample

ArduinoJson 6.14.1

Changes since 6.14.0

• Fixed regression in UTF16 decoding (issue #1173)
• Fixed containsKey() on JsonVariantConst
• Added getElement() and getMember() to JsonVariantConst

View version history

How to install

There are several ways to install ArduinoJson, from simpler to more complex:

1. Use the Arduino Library Manager
2. Download ArduinoJson-v6.14.1.h put it in your project folder
3. Download ArduinoJson-v6.14.1.zip and extract it in you libraries folder

Note: ArduinoJson-v6.14.1.h and ArduinoJson-v6.14.1.hpp are almost identical; the difference is that the .hpp keeps everything in the ArduinoJson namespace.

Try online

• JsonGeneratorExample
• JsonParserExample
• MsgPackParserExample

ArduinoJson 6.14.0

Looking for a human-readable version?
📰 Read the article on arduinojson.org

Changes since 6.13.0

• Added BasicJsonDocument::shrinkToFit()
• Added support of uint8_t for serializeJson(), serializeJsonPretty(), and serializeMsgPack() (issue #1142)
• Added ARDUINOJSON_ENABLE_COMMENTS to enable support for comments (defaults to 0)
• Auto enable support for std::string and std::stream on modern compilers (issue #1156)
  (No need to define ARDUINOJSON_ENABLE_STD_STRING and ARDUINOJSON_ENABLE_STD_STREAM anymore)
• Improved decoding of UTF-16 surrogate pairs (PR #1157 by @kaysievers)
  (ArduinoJson now produces standard UTF-8 instead of CESU-8)
• Added measureJson, measureJsonPretty, and measureMsgPack to keywords.txt
  (This file is used for syntax highlighting in the Arduino IDE)
• Fixed variant.is<nullptr_t>()
• Fixed value returned by serializeJson(), serializeJsonPretty(), and serializeMsgPack() when writing to a String
• Improved speed of serializeJson(), serializeJsonPretty(), and serializeMsgPack() when writing to a String

BREAKING CHANGES ⚠️

Support for comments in input is now optional and disabled by default.

If you need support for comments, you must defined ARDUINOJSON_ENABLE_COMMENTS to 1; otherwise, you'll receive InvalidInput errors.

#define ARDUINOJSON_ENABLE_COMMENTS 1
#include <ArduinoJson.h>

View version history

How to install

There are several ways to install ArduinoJson, from simpler to more complex:

1. Use the Arduino Library Manager
2. Download ArduinoJson-v6.14.0.h put it in your project folder
3. Download ArduinoJson-v6.14.0.zip and extract it in you libraries folder

Note: ArduinoJson-v6.14.0.h and ArduinoJson-v6.14.0.hpp are almost identical; the difference is that the .hpp keeps everything in the ArduinoJson namespace.

Try online

• JsonGeneratorExample
• JsonParserExample
• MsgPackParserExample

ArduinoJson 6.13.0

Looking for a human-readable version?
📰 Read the article on arduinojson.org

Changes since 6.12.0

• Added support for custom writer/reader classes (issue #1088)
• Added conversion from JsonArray and JsonObject to bool, to be consistent with JsonVariant
• Fixed deserializeJson() when input contains duplicate keys (issue #1095)
• Improved deserializeMsgPack() speed by reading several bytes at once
• Added detection of Atmel AVR8/GNU C Compiler (issue #1112)
• Fixed deserializer that stopped reading at the first 0xFF (PR #1118 by @mikee47)
• Fixed dangling reference in copies of MemberProxy and ElementProxy (issue #1120)

View version history

How to install

There are several ways to install ArduinoJson, from simpler to more complex:

1. Use the Arduino Library Manager
2. Download ArduinoJson-v6.13.0.h put it in your project folder
3. Download ArduinoJson-v6.13.0.zip and extract it in you libraries folder

Note: ArduinoJson-v6.13.0.h and ArduinoJson-v6.13.0.hpp are almost identical; the difference is that the .hpp keeps everything in the ArduinoJson namespace.

Try online

• JsonGeneratorExample
• JsonParserExample
• MsgPackParserExample

ArduinoJson 6.12.0

Looking for a human-readable version?
📰 Read the article on arduinojson.org

Changes since 6.11.5

• Use absolute instead of relative includes (issue #1072)
• Changed JsonVariant::as<bool>() to return true for any non-null value (issue #1005)
• Moved ancillary files to extras/ (issue #1011)

View version history

How to install

There are several ways to install ArduinoJson, from simpler to more complex:

1. Use the Arduino Library Manager
2. Download ArduinoJson-v6.12.0.h put it in your project folder
3. Download ArduinoJson-v6.12.0.zip and extract it in you libraries folder

Note: ArduinoJson-v6.12.0.h and ArduinoJson-v6.12.0.hpp are almost identical; the difference is that the .hpp keeps everything in the ArduinoJson namespace.

Try online

• JsonGeneratorExample
• JsonParserExample
• MsgPackParserExample

ArduinoJson 6.11.5

Changes since 6.11.4

• Added fallback implementations of strlen_P(), strncmp_P(), strcmp_P(), and memcpy_P() (issue #1073)

View version history

How to install

There are several ways to install ArduinoJson, from simpler to more complex:

1. Use the Arduino Library Manager
2. Download ArduinoJson-v6.11.5.h put it in your project folder
3. Download ArduinoJson-v6.11.5.zip and extract it in you libraries folder

Note: ArduinoJson-v6.11.5.h and ArduinoJson-v6.11.5.hpp are almost identical; the difference is that the .hpp keeps everything in the ArduinoJson namespace.

Try online

• JsonGeneratorExample
• JsonParserExample
• MsgPackParserExample

ArduinoJson 6.11.4

Changes since 6.11.3

• Added measureJson() to the ArduinoJson namespace (PR #1069 by @nomis)
• Added support for basic_string<char, traits, allocator> (issue #1045)
• Fixed example JsonConfigFile.ino for ESP8266
• Include Arduino.h if ARDUINO is defined (PR #1071 by @nomis)

View version history

How to install

There are several ways to install ArduinoJson, from simpler to more complex:

1. Use the Arduino Library Manager
2. Download ArduinoJson-v6.11.4.h put it in your project folder
3. Download ArduinoJson-v6.11.4.zip and extract it in you libraries folder

Note: ArduinoJson-v6.11.4.h and ArduinoJson-v6.11.4.hpp are almost identical; the difference is that the .hpp keeps everything in the ArduinoJson namespace.

Try online

• JsonGeneratorExample
• JsonParserExample
• MsgPackParserExample

ArduinoJson 6.11.3

Changes since 6.11.2

• Added operators == and != for JsonDocument, ElementProxy, and MemberProxy
• Fixed comparison of JsonVariant when one contains a linked string and the other contains an owned string (issue #1051)

View version history

How to install

There are several ways to install ArduinoJson, from simpler to more complex:

1. Use the Arduino Library Manager
2. Download ArduinoJson-v6.11.3.h put it in your project folder
3. Download ArduinoJson-v6.11.3.zip and extract it in you libraries folder

Note: ArduinoJson-v6.11.3.h and ArduinoJson-v6.11.3.hpp are almost identical; the difference is that the .hpp keeps everything in the ArduinoJson namespace.

Try online

• JsonGeneratorExample
• JsonParserExample
• MsgPackParserExample

ArduinoJson 6.11.2

Changes since 6.11.1

• Fixed assignment of JsonDocument to JsonVariant (issue #1023)
• Fix invalid conversion error on Particle Argon (issue #1035)

View version history

How to install

There are several ways to install ArduinoJson, from simpler to more complex:

1. Use the Arduino Library Manager
2. Download ArduinoJson-v6.11.2.h put it in your project folder
3. Download ArduinoJson-v6.11.2.zip and extract it in you libraries folder

Note: ArduinoJson-v6.11.2.h and ArduinoJson-v6.11.2.hpp are almost identical; the difference is that the .hpp keeps everything in the ArduinoJson namespace.

Try online

• JsonGeneratorExample
• JsonParserExample
• MsgPackParserExample

ArduinoJson 6.11.1

Changes since 6.11.0

• Fixed serialized() not working with Flash strings (issue #1030)

View version history

How to install

There are several ways to install ArduinoJson, from simpler to more complex:

1. Use the Arduino Library Manager
2. Download ArduinoJson-v6.11.1.h put it in your project folder
3. Download ArduinoJson-v6.11.1.zip and extract it in you libraries folder

Note: ArduinoJson-v6.11.1.h and ArduinoJson-v6.11.1.hpp are almost identical; the difference is that the .hpp keeps everything in the ArduinoJson namespace.

Try online

• JsonGeneratorExample
• JsonParserExample
• MsgPackParserExample