std::basic_string<CharT,Traits,Allocator>::capacity
С сайта ru.cppreference.net
size_type capacity() const;
|
(noexcept начиная с C++11) (constexpr начиная с C++20) |
|
Возвращает количество символов, для которых в данный момент выделена память в строке.
Параметры
(нет)
Возвращаемое значение
Ёмкость текущего выделенного хранилища, то есть пространство, доступное для хранения элементов.
Сложность
Константа.
Примечания
Полученные от аллокатора участки памяти, недоступные для хранения любого элемента, не учитываются в выделенном хранилище. Обратите внимание, что нулевой терминатор не является элементом std::basic_string .
Пример
Запустить этот код
#include <iomanip> #include <iostream> #include <string> void show_capacity(std::string const& s) { std::cout << std::quoted(s) << " has capacity " << s.capacity() << ".\n"; } int main() { std::string s{"Exemplar"}; show_capacity(s); s += " is an example string."; show_capacity(s); s.clear(); show_capacity(s); std::cout << "\nDemonstrate the capacity's growth policy." "\nSize: Capacity: Ratio:\n" << std::left; std::string g; auto old_cap{g.capacity()}; for (int mark{}; mark != 5; ++mark) { while (old_cap == g.capacity()) g.push_back('.'); std::cout << std::setw( 7) << g.size() << std::setw(11) << g.capacity() << std::setw(10) << g.capacity() / static_cast<float>(old_cap) << '\n'; old_cap = g.capacity(); } }
Возможный вывод:
"Exemplar" has capacity 15. "Exemplar is an example string." has capacity 30. "" has capacity 30. Demonstrate the capacity's growth policy. Size: Capacity: Ratio: 16 30 2 31 60 2 61 120 2 121 240 2 241 480 2
Смотрите также
|
возвращает количество символов
(public member function) |
|
|
резервирует память
(public member function) |