JsonDocument::capacity()
Description
JsonDocument::capacity() returns the capacity of the memory pool of the JsonDocument.
Unlike JsonDocument::memoryUsage(), the result of JsonDocument::capacity() doesn’t change during the life of the JsonDocument::memoryUsage().
For StaticJsonDocument, the result is always equal to the capacity set as a template parameter.
For DynamicJsonDocument, the result should be equals to the capacity set in the constructor, but it can be zero if the memory allocation failed.
Use this function to check that the memory allocation succeeded.
Signature
size_t capacity() const;
Example
StaticJsonDocument
StaticJsonDocument<256> doc;
doc.capacity(); // 256
DynamicJsonDocument
DynamicJsonDocument doc(1024);
doc.capacity(); // 1024
Zero when allocation fails
DynamicJsonDocument doc(1000000000);
doc.capacity(); // 0
