Description

JsonArray::createNestedArray() appends a new array to the array pointed by the JsonArray.

If the JsonArray is null/unbound, this function does nothing.

Signature

JsonArray createNestedArray() const;

Return value

JsonArray::createNestedArray() returns a JsonArray that points to the newly created array.

JsonArray::createNestedArray() returns null if the memory allocation fails; in which case JsonArray::isNull(), returns true.

Example

StaticJsonDocument<200> doc;
JsonArray array = doc.to<JsonArray>();
array.add("hello");
JsonArray nested = array.createNestedArray();
nested.add("world");
serializeJson(array, Serial);

will write

["hello",["world"]]

See also

Global warming stripes by Professor Ed Hawkins (University of Reading)