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

void resize( size_type count );

void resize( size_type count, const value_type& value );

Изменяет размер контейнера на count элементов, не делает ничего, если count == size().

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

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

Параметры

Возвращаемое значение

(нет)

Сложность

Линейная от разницы между текущим размером и count. Дополнительная сложность возможна из-за перераспределения, если вместимость меньше count.

Исключение

Если возникает исключение по любой причине, эти функции не оказывают никакого эффекта (гарантия устойчивости к исключениям). Хотя это не указано явно, std::length_error выбрасывается, если требуемая вместимость нового вектора превысит max_size().

Примечания

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

Пример

#include <vector>
#include <iostream>
 
void print(auto rem, const std::vector<int>& c)
{
    for (std::cout << rem; const int el : c)
        std::cout << el << ' ';
    std::cout << '\n';    
}
 
int main()
{
    std::vector<int> c = {1, 2, 3};
    print("The vector 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 vector 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++.

См. также