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

template< container-compatible-range<T> R >
constexpr void append_range( R&& rg );

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

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

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

Параметры

Сложность

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

Исключения

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

Примечания

Пример

#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}));
}

См. также