Пространства имён
Варианты
Действия

cpp/string/basic string/reserve — различия между версиями

Материал из cppreference.com
< cpp‎ | string‎ | basic string
 
Строка 1: Строка 1:
−
{{cpp/string/basic_string/title | reserve}}
+
{{cpp/string/basic_string/title|reserve}}
 
{{cpp/string/basic_string/navbar}}
 
{{cpp/string/basic_string/navbar}}
−
{{ddcl |
+
{{
−
void reserve( size_type size );
+
 +
 +
 +
|
 +
void reserve( size_type );
 
}}
 
}}
 +
 +
 +
 +
  
−
Задает емкость строки, минимум {{tt|size}}. Новая память для хранения выделяется при необходимости.
+
{{tt|}} .
 +
выделяется
 +
 +
 +
 +
 +
 +
 +
 
 +
 +
 
 +
.
  
 
===Параметры===
 
===Параметры===
 
{{par begin}}
 
{{par begin}}
−
{{par | size |новая емкость строки}}
+
{{par||новая строки}}
 
{{par end}}
 
{{par end}}
  
 
===Возвращаемое значение===
 
===Возвращаемое значение===
−
(Нет)
+
()
 +
 
 +
 +
 +
 
 +
 +
 
 +
  
 
===Сложность===
 
===Сложность===
−
линейная по размеру строки
+
линейная по строки
 +
 
 +
 +
 +
 +
 +
 +
 +
 
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 
 +
 +
 +
 +
  
−
===См. также===
+
===также===
 
{{dsc begin}}
 
{{dsc begin}}
−
{{dsc inc | cpp/string/basic_string/dsc capacity}}
+
{{dsc inc|cpp/string/basic_string/dsc capacity
 +
}}
 
{{dsc end}}
 
{{dsc end}}
  
−
[[de:cpp/string/basic string/reserve]]
+
deenesfritjaptzh
−
[[en:cpp/string/basic string/reserve]]
+
−
[[es:cpp/string/basic string/reserve]]
+
−
[[fr:cpp/string/basic string/reserve]]
+
−
[[it:cpp/string/basic string/reserve]]
+
−
[[ja:cpp/string/basic string/reserve]]
+
−
[[pt:cpp/string/basic string/reserve]]
+
−
[[zh:cpp/string/basic string/reserve]]
+

Текущая версия на 05:05, 20 октября 2023

 
C++
Поддержка компилятором
Автономные и размещённые реализации
Язык
Стандартная библиотека
Заголовки стандартной библиотеки
Требования к именованию
Макросы тестирования функциональности (C++20)
Поддержка языка
Библиотека концептов (C++20)
Библиотека метапрограммирования (C++11)
Библиотека диагностики
Библиотека общих утилит
Библиотека строк
Библиотека контейнеров
Библиотека итераторов
Библиотека диапазонов (C++20)
Библиотека алгоритмов
Библиотека численных данных
Библиотека ввода/вывода
Библиотека локализаций
Регулярные выражения (C++11)
Атомарные операции (C++11)
Библиотека поддержки конкуренции (C++11)
Библиотека файловой системы (C++17)
Технические спецификации
Указатель символов
Внешние библиотеки
 
Строки
 
std::basic_string
Функции-элементы
(C++23)
Доступ к элементам
(DR*)
(DR*)
(C++17)
Итераторы
(DR*)
(DR*)
(DR*)
(DR*)
Ёмкость
basic_string::reserve
(DR*)
Операции
(C++23)
(DR*)
(C++23)
(C++23)
(C++23)  
Поиск
(C++20)  
(C++20)
(C++23)
Константы
Правила вывода (C++17)
Функции, не являющиеся элементами
(C++14)
(C++20)(C++20)
Ввод/Вывод
Сравнение
(до C++20)(до C++20)(до C++20)(до C++20)(до C++20)(C++20)
Числовые преобразования
(C++11)(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)(C++11)
(C++11)
(C++11)
Вспомогательные классы
(C++11)  (C++11)(C++11)(C++11)(C++20)
(C++17)(C++17)(C++17)(C++17)(C++20)
 
(1)
void reserve( size_type new_cap = 0 );
 (до C++20)
constexpr void reserve( size_type new_cap );
 (начиная с C++20)
void reserve();
 (2) (начиная с C++20)
(устарело)
1) Информирует объект std::basic_string о запланированном изменении размера, чтобы он мог соответствующим образом управлять распределением памяти.
  • Если new_cap больше текущего значения capacity(), выделяется новое хранилище, а capacity() становится равным или большим, чем new_cap.
  • Если new_cap меньше текущего значения capacity(), это необязательный запрос на сжатие.
  • Если new_cap меньше текущего size(), это необязательный запрос на сжатие эквивалентный shrink_to_fit() (начиная с C++11).
(до C++20)
  • Если new_cap меньше или равно текущему capacity(), эффекта нет.
(начиная с C++20)
Если происходит изменение ёмкости, все итераторы и ссылки, включая итератор вставки в конец, становятся недействительными.
2) Необязательный запрос на усадку по размеру. После этого вызова capacity() имеет неопределённое значение, большее или равное size().

Содержание

[править] Параметры

new_cap — новая ёмкость строки

[править] Возвращаемое значение

(нет)

[править] Исключения

Генерирует std::length_error, если new_cap больше, чем max_size().

Может генерировать любые исключения, создаваемые std::allocator_traits<Allocator>::allocate(), например std::bad_alloc.

Если по какой-либо причине генерируется исключение, эта функция не имеет эффекта (строгая гарантия безопасности исключений).

[править] Сложность

Максимально линейная по size() строки.

[править] Пример

Запустить этот код
#include <cassert>
#include <iostream>
#include <string>
 
int main()
{
    std::string s;
    const std::string::size_type new_capacity{100u};
    std::cout << "Перед: " << s.capacity() << '\n';
 
    s.reserve(new_capacity);
    std::cout << "После:  " << s.capacity() << '\n';
    assert(new_capacity <= s.capacity());
 
    // наблюдение коэффициента роста ёмкости
    auto cap{s.capacity()};
    for (int check{}; check != 4; ++check)
    {
        while (cap == s.capacity())
            s += '$';
        cap = s.capacity();
        std::cout << "Новая ёмкость: " << cap << '\n';
    }
 
    // s.reserve(); // не рекомендуется в C++20, используйте:
    s.shrink_to_fit();
    std::cout << "После:  " << s.capacity() << '\n';
}

Возможный вывод: 

Перед: 15
После:  100
Новая ёмкость: 200
Новая ёмкость: 400
Новая ёмкость: 800
Новая ёмкость: 1600
После:  801

[править] Отчёты о дефектах

Следующие изменения поведения были применены с обратной силой к ранее опубликованным стандартам C++:

Номер Применён Поведение в стандарте Корректное поведение
LWG 847 C++98 не было гарантии безопасности исключений добавлена надёжная гарантия безопасности исключений

[править] Смотрите также

 возвращает количество символов, которые могут храниться в выделенной в данный момент памяти
(public функция-элемент) [править]
изменяет количество сохранённых символов
(public функция-элемент) [править]
Источник — «https://ru.cppreference.com/mwiki/index.php?title=cpp/string/basic_string/reserve&oldid=63802»