std::list<T,Allocator>::resize
void resize( size_type count ); | (1) | |
void resize( size_type count, const value_type& value ); | (2) |
Изменяет размер контейнера так, чтобы он содержал count элементов; ничего не делает, если count == size().
Если текущий размер больше count, размер контейнера уменьшается до первых count элементов.
Если текущий размер меньше count, то:
value.Параметры
| count | - | новый размер контейнера |
| value | - | значение для инициализации новых элементов |
| Требования к типам | ||
-T должен соответствовать требованиям DefaultInsertable для использования перегрузки (1). |
||
-T должен соответствовать требованиям CopyInsertable для использования перегрузки (2). |
||
Сложность
Линейная относительно разности между текущим размером и count.
Примечания
Если инициализация значением в перегрузке (1) нежелательна — например, если элементы имеют несклассовый тип и обнуление не требуется, — ее можно избежать, предоставив пользовательский Allocator::construct.
Пример
#include <list>
#include <iostream>
void print(auto rem, const std::list<int>& c)
{
for (std::cout << rem; const int el : c)
std::cout << el << ' ';
std::cout << '\n';
}
int main()
{
std::list<int> c = {1, 2, 3};
print("The list holds: ", c);
c.resize(5);
print("After resize up to 5: ", c);
c.resize(2);
print("After resize down to 2: ", c);
c.resize(6, 4);
print("After resize up to 6 (initializer = 4): ", c);
}
Вывод:
The list holds: 1 2 3 After resize up to 5: 1 2 3 0 0 After resize down to 2: 1 2 After resize up to 6 (initializer = 4): 1 2 4 4 4 4
Отчеты об ошибках
Следующие отчеты об ошибках, изменяющие поведение, были применены задним числом к ранее опубликованным стандартам C++.
| DR | Применен к | Опубликованное поведение | Корректное поведение |
|---|---|---|---|
| LWG 132 | C++98 | для определения диапазона удаления использовались итераторы произвольного доступа | используются двунаправленные итераторы |
| LWG 679 | C++98 |
resize() передавался value по значению | передается по константной ссылке |
| LWG 1420 | C++98 | поведение resize(size()) не было определено | определено |
См. также
| возвращает максимально возможное количество элементов (открытая функция-член) |
|
| возвращает количество элементов (открытая функция-член) |
|
| проверяет, пуст ли контейнер (открытая функция-член) |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/container/list/resize