Description

JsonDocument::getOrCreate() reproduces JsonObject::getOrCreate(). It requires that the JsonDocument contains an object, and it can convert the document if needed.

Instead of this function, you can use JsonDocument::operator[] which offers a more intuitive syntax.

Signatures

JsonVariant getOrCreate(const char* key);
JsonVariant getOrCreate(String key);
JsonVariant getOrCreate(std::string key);
JsonVariant getOrCreate(const __FlashStringHelper* key);

Arguments

key: the key of the value in the object.

As usual, ArduinoJson makes a copy of the key in the JsonDocument, except if it’s a const char*.

Return value

If the key is already present in the object, this function returns a JsonVariant that points to the associated value.

If the key is not present in the object, this function adds a new key-value pair to the object and returns a JsonVariant that points to the value. The returned JsonVariant could be null if there were not enough room in the JsonDocument.

See also