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

Изменяет размер контейнера для хранения count элементов:

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

Параметры

Сложность

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

Исключения

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

Примечания

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

Пример

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

1. ↑ erase() может удалять элементы в середине vector , поэтому тип значения должен быть MoveAssignable , чтобы следующие за удаленным участком элементы могли быть перемещены вперед для заполнения пробела. Однако, resize() может удалять элементы только в конце vector , что делает требование MoveAssignable излишним.
2. ↑ Удаление элементов с помощью pop_back() подразумевает, что элементы должны удаляться с конца к началу.

Смотрите также