std::deque<T,Allocator>:: insert_range

Fügt, in nicht umgekehrter Reihenfolge, Kopien der Elemente in rg vor pos ein.

Alle Iteratoren (einschließlich des end() Iterators) werden ungültig. Referenzen werden ebenfalls ungültig, es sei denn pos == begin() oder pos == end() , in welchem Fall sie nicht ungültig werden.

Jeder Iterator im Bereich rg wird genau einmal dereferenziert.

Wenn rg sich mit * this überschneidet, ist das Verhalten undefiniert.

Parameter

Rückgabewert

Ein Iterator auf das erste in * this eingefügte Element, oder pos falls rg leer ist.

Hinweise

Beispiel

#include <algorithm>
#include <cassert>
#include <iterator>
#include <deque>
#include <list>
int main()
{
    auto container = std::deque{1, 2, 3, 4};
    auto pos = std::next(container.begin(), 2);
    assert(*pos == 3);
    const auto rg = std::list{-1, -2, -3};
#ifdef __cpp_lib_containers_ranges
    container.insert_range(pos, rg);
#else
    container.insert(pos, rg.cbegin(), rg.cend());
#endif
    assert(std::ranges::equal(container, std::deque{1, 2, -1, -2, -3, 3, 4}));
}

Siehe auch