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

rg で指定された範囲の要素のコピーを pos の後に挿入します。範囲 rg 内の各イテレータは正確に1回デリファレンスされます。

以下のいずれかの条件が満たされる場合、動作は未定義です：

• T は EmplaceConstructible ではなく、 forward_list に * ranges:: begin ( rg ) から構築できません。
• pos が範囲 [ before_begin() , end() ) 内にありません。
• rg と * this が重複しています。

イテレータや参照は無効化されません。

パラメータ

戻り値

最後に挿入された要素へのイテレータ、または pos が rg が空の場合。

計算量

rg のサイズに対して線形。

注記

例

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

関連項目