Get the maximum size that the buffer may grow to without triggering reallocation.

std::size_t capacity() const;

Return Value

The current capacity of the underlying string if less than max_size(). Otherwise returns max_size().