Spec-Zone.ru › C++

std::forward_list<T,Allocator>::resize

void resize( size_type count );
(1) (начиная с C++11)
void resize( size_type count, const value_type& value );
(2) (начиная с C++11)

Изменяет размер контейнера так, чтобы он содержал count элементов; ничего не делает, если count == std::distance(begin(), end()) (то есть если count равен текущему размеру).

Если текущий размер больше count, контейнер сокращается до первых count элементов.

Если текущий размер меньше count, то:

1) Добавляются дополнительные элементы, вставленные по умолчанию.
2) Добавляются дополнительные копии value.

Параметры

count - новый размер контейнера
value - значение, которым инициализируются новые элементы
Требования к типам
-T должен соответствовать требованиям DefaultInsertable для использования перегрузки (1).
-T должен соответствовать требованиям CopyInsertable для использования перегрузки (2).

Сложность

Линейная относительно разницы между текущим размером и count. Возможны дополнительные затраты из-за обхода списка для достижения первого удаляемого элемента или конечной позиции вставки.

Примечания

Если инициализация значением в перегрузке (1) нежелательна, например, если элементы не являются объектами классов и обнуление не требуется, этого можно избежать, предоставив пользовательский Allocator::construct.

Пример

#include <forward_list>
#include <iostream>

void print(auto rem, const std::forward_list<int>& c)
{
    for (std::cout << rem; const int el : c)
        std::cout << el << ' ';
    std::cout << '\n';
}

int main()
{
    std::forward_list<int> c = {1, 2, 3};
    print("The forward_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 forward_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

См. также

max_size
возвращает максимально возможное количество элементов
(открытая функция-член)
empty
проверяет, пуст ли контейнер
(открытая функция-член)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/container/forward_list/resize

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API