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, если вместимость, необходимая для нового vector, превышает max_size().

Примечания

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

Пример

#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++.

См. также