object::capacity

Return the number of elements that can be held in currently allocated memory.

Synopsis

std::size_t
capacity() const noexcept;

Description

This number may be larger than the value returned by size().

Complexity

Constant.

Exception Safety

No-throw guarantee.