Namespaces
Variants

    std::back_insert_iterator

    ja.cppreference.net より
     
    C++
    コンパイラサポート
    フリースタンディングとホステッド
    言語
    標準ライブラリ
    標準ライブラリヘッダ
    名前付き要件
    機能テストマクロ (C++20)
    言語サポートライブラリ
    コンセプトライブラリ (C++20)
    診断ライブラリ
    メモリ管理ライブラリ
    メタプログラミングライブラリ (C++11)
    汎用ユーティリティライブラリ
    コンテナライブラリ
    イテレータライブラリ
    範囲ライブラリ (C++20)
    アルゴリズムライブラリ
    文字列ライブラリ
    テキスト処理ライブラリ
    数値ライブラリ
    日時ライブラリ
    入出力ライブラリ
    ファイルシステムライブラリ (C++17)
    並行処理サポートライブラリ (C++11)
    実行制御ライブラリ (C++26)
    技術仕様書
    シンボル索引
    外部ライブラリ
     
    イテレータライブラリ
    イテレータコンセプト
    イテレータプリミティブ
    アルゴリズムコンセプトとユーティリティ
    間接呼び出し可能コンセプト
    共通アルゴリズム要件
    (C++20)
    (C++20)
    (C++20)
    ユーティリティ
    (C++20)
    イテレータアダプタ
    範囲アクセス
    (C++11)(C++14)
    (C++14)(C++14)  
    (C++11)(C++14)
    (C++14)(C++14)  
    (C++17)(C++20)
    (C++17)
    (C++17)
     
    std::back_insert_iterator
     
    ヘッダで定義<iterator> 
    template< class Container >
class back_insert_iterator
    : public std::iterator<std::output_iterator_tag, void, void, void, void>
    		(C++17まで) 
    template< class Container >
class back_insert_iterator;
    		(C++17以降)

    std::back_insert_iterator は LegacyOutputIteratorであり、構築時に指定されたコンテナに要素を追加します。コンテナの push_back() メンバ関数が、イテレータ（間接参照の有無にかかわらず）に代入されるたびに呼び出されます。std::back_insert_iterator をインクリメントしても何も行われません。

    メンバー型

    メンバー型 定義
    iterator_category std:: output_iterator_tag
    value_type void
    difference_type

    void

    		(C++20まで)

    std::ptrdiff_t

    		(C++20以降)
    pointer void
    reference void
    container_type Container

    メンバ型 iterator_category , value_type , difference_type , pointer および reference は、 std:: iterator < std:: output_iterator_tag , void , void , void , void > からの継承によって取得することが要求される。

    		(C++17まで)

    メンバー関数

    		新しい back_insert_iterator を構築する
    (public member function)
    		オブジェクトを関連付けられたコンテナに挿入する
    (public member function)
    		何もしない操作
    (public member function)
    		何もしない操作
    (public member function)

    メンバーオブジェクト

    メンバー名 定義
    container (protected) Container* 型のポインタ

    例

    このコードを実行 
    #include <algorithm>
#include <iostream>
#include <iterator>
#include <vector>
int main()
{
    std::vector<int> v;
    std::generate_n(
        std::back_insert_iterator<std::vector<int>>(v),
            // または std::back_inserter ヘルパーを使用
            // または C++17 の構文 std::back_insert_iterator(v) を使用
        10,
        [n = 0]() mutable { return ++n; }
    );
    for (int n : v)
        std::cout << n << ' ';
    std::cout << '\n';
}

    出力: 

    1 2 3 4 5 6 7 8 9 10

    関連項目

    		引数の型から推論される型の std::back_insert_iterator を作成する
    (関数テンプレート)
    		コンテナの先頭への挿入用イテレータアダプタ
    (クラステンプレート)
    		コンテナへの挿入用イテレータアダプタ
    (クラステンプレート)