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

Вставляет копии элементов из диапазона rg перед end() , в прямом порядке.

Если после операции новый size() превышает старый capacity() , происходит перераспределение памяти, и в этом случае все итераторы (включая итератор end() ) и все ссылки на элементы становятся недействительными. В противном случае недействительным становится только итератор end() .

Каждый итератор в rg разыменовывается ровно один раз.

Параметры

Сложность

Если происходит перераспределение памяти, сложность линейна по количеству элементов в результирующем vector ; в противном случае - линейна по количеству вставленных элементов плюс расстояние до end() .

Исключения

Если исключение выбрасывается не конструктором копирования, конструктором перемещения, оператором присваивания или оператором перемещающего присваивания T или любой операцией InputIterator , эффекты отсутствуют. Если исключение выбрасывается при вставке отдельного элемента в конец и T является CopyInsertable или std::is_nothrow_move_constructible_v <T> равно true , эффекты отсутствуют. В противном случае, если исключение выбрасывается конструктором перемещения не- CopyInsertable T , эффекты не определены.

Примечания

Пример

#include <cassert>
#include <vector>
#include <list>
int main()
{
    auto head = std::vector{1, 2, 3, 4};
    const auto tail = std::list{-5, -6, -7};
#ifdef __cpp_lib_containers_ranges
    head.append_range(tail);
#else
    head.insert(head.end(), tail.cbegin(), tail.cend());
#endif
    assert((head == std::vector{1, 2, 3, 4, -5, -6, -7}));
}

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