ARDUINOJSON_DECODE_UNICODE

ArduinoJson can decode Unicode escape sequences (\uXXXX) in JSON documents, but you can disable this feature to reduce the library’s size.

ArduinoJson doesn’t handle NUL correctly: in your input contains \u0000, the string will be truncated.

Description

When ARDUINOJSON_DECODE_UNICODE is set to 1, deserializeJson() converts the Unicode escape sequences to UTF-8 characters.

When ARDUINOJSON_DECODE_UNICODE is set to 0, deserializeJson() returns NotSupported when the input contains a Unicode escape sequence.

The default value is 1.

Only 0 and 1 are valid. Any other value (like false or true) will produce a compilation error.

Impact on code size

This feature increases the library’s size; that’s why it used to be disabled by default. The size increase depends on the microcontroller’s architecture, as you can see in the table below.

Architecture	Code size	Boards (non exhaustive)
ARM Cortex-M0	236 bytes	Adafruit Circuit Playground Express Arduino MKR ZERO Arduino MKR1000 Arduino MKR WiFi 1010 Arduino NANO 33 IoT Arduino MKR WAN 1300 Arduino MKR WAN 1310 Arduino MKR GSM 1400 Arduino MKR Vidor 4000 Nucleo-32 Nucleo-64 STM32 Discovery Teensy LC
ARM Cortex-M3	256 bytes	Arduino Due Nucleo-144 Maple Mini
ARM Cortex-M4	640 bytes	Teensy 3.2 Teensy 3.5 Teensy 3.6
ARM Cortex-M7	576 bytes	Teensy 4.0
AVR	334 bytes	Adafruit Feather 32u4 Bluefruit LE Adafruit Metro Mini 328 Arduino Mega 2560 Arduino UNO Arduino UNO WiFi Arduino Leonardo Arduino Micro Arduino Nano Arduino Yún SparkFun RedBoard Teensy 2.0 Teensy++ 2.0
megaAVR	330 bytes	Arduino Nano Every Arduino UNO WiFi Rev 2
ESP32	284 bytes	Adafruit HUZZAH32 LoLin D32 Pro
ESP8266	304 bytes	Adafruit HUZZAH SparkFun ESP8266 Thing WeMos D1 Mini

These results depend on the compiler version.

How to disable support for Unicode characters in ArduinoJson?

If your input doesn’t contain any Unicode escape sequence, you remove this feature to reduce the library’s size. To do so, simply define ARDUINOJSON_DECODE_UNICODE to 0 before including ArduinoJson.h.

#define ARDUINOJSON_DECODE_UNICODE 0
#include <ArduinoJson.h>

Example

JsonDocument doc;

deserializeJson(doc, "{'firstname':'Beno\\u00EEt'}");
    
Serial.println(doc["firstname"].as<const char*>()); // Benoît

👨‍🏫 Try this example online

Several .ino or .cpp files?

Be careful if several compilation units compose your program, i.e., if your project contains several .ino or .cpp files.

You should define the same value of ARDUINOJSON_DECODE_UNICODE in each compilation unit; otherwise, the executable will be much bigger because it will contain two variants of the library.

Description

Impact on code size

How to disable support for Unicode characters in ArduinoJson?

Example

Several .ino or .cpp files?

Several `.ino` or `.cpp` files?