JsonVariant::remove()

Description

Depending on the type of its argument, JsonVariant::remove() either:

• removes the element at the specified index from the array pointed by the JsonVariant
• removes the member with the specified key in the object pointed by the JsonVariant

In other words, JsonVariant::remove() behaves like JsonArray::remove() or JsonObject::remove().

Causes memory leaks ⚠️

Because JsonDocument contains a monotonic allocator, this function cannot release the memory associated with the removed value.
Consequently, you cannot call this function in a loop; otherwise, the JsonDocument will overflow.

Signature

void remove(size_t index) const;

void remove(const char* key) const;
void remove(const __FlashStringHelper* key) const;
void remove(const String& key) const;
void remove(const std::string& key) const;
void remove(std::string_view key) const;  // 🆕 (added in 6.18.1)

Arguments

index: the zero-based position of the array element to remove.

key: the key of the object member to remove

See also

• JsonArray::remove()
• JsonObject::remove()