std::forward_list<T,Allocator>:: insert_range_after

Fügt Kopien der Elemente im Bereich rg nach pos ein. Jeder Iterator im Bereich rg wird genau einmal dereferenziert.

Wenn eine der folgenden Bedingungen erfüllt ist, ist das Verhalten undefiniert:

• T ist nicht EmplaceConstructible in forward_list von * ranges:: begin ( rg ) .
• pos liegt nicht im Bereich [ before_begin() , end() ) .
• rg und * this überlappen sich.

Keine Iteratoren oder Referenzen werden ungültig.

Parameter

Rückgabewert

Ein Iterator auf das letzte eingefügte Element, oder pos falls rg leer ist.

Komplexität

Linear in der Größe von rg .

Hinweise

Beispiel

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

Siehe auch