std::basic_string<CharT,Traits,Allocator>::capacity
size_type capacity() const; | (until C++11) | |
size_type capacity() const noexcept; | (since C++11) |
Returns the number of characters that the string has currently allocated space for.
Parameters
(none).
Return value
Capacity of the currently allocated storage.
Complexity
Constant.
Example
#include <iostream> #include <string> void show_capacity(std::string const& s) { std::cout << "'" << s << "' has capacity " << s.capacity() << ".\n"; } int main() { std::string s{"Exemplar"}; show_capacity(s); s += " is an example string."; show_capacity(s); }
Possible output:
'Exemplar' has capacity 15. 'Exemplar is an example string.' has capacity 30.
See also
returns the number of characters (public member function) |
|
reserves storage (public member function) |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
http://en.cppreference.com/w/cpp/string/basic_string/capacity