Namespaces
Variants

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

From cppreference.net
C++
Containers library
std::forward_list
Member functions
Non-member functions
(until C++20) (until C++20) (until C++20) (until C++20) (until C++20)
Deduction guides (C++17)
iterator insert_after ( const_iterator pos, const T & value ) ;
(1) (C++11以降)
(constexpr since C++26)
iterator insert_after ( const_iterator pos, T && value ) ;
(2) (C++11以降)
(constexpr since C++26)
iterator insert_after ( const_iterator pos,
size_type count, const T & value ) ;
(3) (C++11以降)
(constexpr since C++26)
template < class InputIt >

iterator insert_after ( const_iterator pos,

InputIt first, InputIt last ) ;
(4) (C++11以降)
(constexpr since C++26)
iterator insert_after ( const_iterator pos,
std:: initializer_list < T > ilist ) ;
(5) (C++11以降)
(constexpr since C++26)

指定された位置の後に要素をコンテナに挿入します。 pos が before_begin() の場合、最初に挿入された要素（存在すれば）は * this の最初の要素になります。

pos が範囲 [ before_begin() , end() ) 内にない場合、動作は未定義です。

1,2) pos の後に value のコピーを挿入します。
1) T が CopyInsertable でない場合、動作は未定義です。
2) T が MoveInsertable でない場合、動作は未定義です。
3) pos の後に value の count 個のコピーを挿入します。
T が CopyInsertable でない場合、 forward_list への挿入時の動作は未定義です。
4) 範囲 [ first , last ) の要素を pos の後に挿入します。
このオーバーロードは、 InputIt が LegacyInputIterator の要件を満たす場合にのみ、オーバーロード解決に参加します。
以下のいずれかの条件が満たされる場合、動作は未定義です：
  • T が EmplaceConstructible から forward_list へ * first によって構築可能でない場合。
  • first または last が * this へのイテレータである場合。
5) 初期化子リストから要素を挿入 ilist の後ろに pos を配置します。
次と同等 return insert_after ( position, ilist. begin ( ) , ilist. end ( ) ) ; 。

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

目次

パラメータ

pos - コンテンツを挿入する位置の後ろを指すイテレータ
value - 挿入する要素の値
count - 挿入するコピーの数
first, last - 挿入する要素のソース 範囲 を定義するイテレータのペア
ilist - 値を挿入する初期化子リスト

戻り値

1,2) 挿入された要素へのイテレータ。
3) 挿入された最後の要素へのイテレータ、または pos が count == 0 の場合。
4) 挿入された最後の要素へのイテレータ、または pos が first == last の場合 true です。
5) 挿入された最後の要素へのイテレータ、または pos が ilist 空の場合。

例外

何らかの理由で例外がスローされた場合、これらの関数は何も効果を持ちません（ strong exception safety guarantee ）。

計算量

1,2) 定数。
3) 線形（ count に比例）。
4) std:: distance ( first, last ) の計算量は線形です。
5) 線形で ilist. size ( ) に比例します。

例

このコードを実行 
#include <forward_list>
#include <iostream>
#include <string>
#include <vector>
void print(const std::forward_list<int>& list)
{
    std::cout << "list: {";
    for (char comma[3] = {'\0', ' ', '\0'}; int i : list)
    {
        std::cout << comma << i;
        comma[0] = ',';
    }
    std::cout << "}\n";
}
int main()
{
    std::forward_list<int> ints{1, 2, 3, 4, 5};
    print(ints);
    // insert_after (2)
    auto beginIt = ints.begin();
    ints.insert_after(beginIt, -6);
    print(ints);
    // insert_after (3)
    auto anotherIt = beginIt;
    ++anotherIt;
    anotherIt = ints.insert_after(anotherIt, 2, -7);
    print(ints);
    // insert_after (4)
    const std::vector<int> v = {-8, -9, -10};
    anotherIt = ints.insert_after(anotherIt, v.cbegin(), v.cend());
    print(ints);
    // insert_after (5)
    ints.insert_after(anotherIt, {-11, -12, -13, -14});
    print(ints);
}

出力: 

list: {1, 2, 3, 4, 5}
list: {1, -6, 2, 3, 4, 5}
list: {1, -6, -7, -7, 2, 3, 4, 5}
list: {1, -6, -7, -7, -8, -9, -10, 2, 3, 4, 5}
list: {1, -6, -7, -7, -8, -9, -10, -11, -12, -13, -14, 2, 3, 4, 5}

関連項目

要素を要素の直後にその場で構築する
(公開メンバ関数)
要素を先頭に挿入する
(公開メンバ関数)