Namespaces
Variants

std:: front_inserter

From cppreference.net
Iterator library
Iterator concepts
Iterator primitives
Algorithm concepts and utilities
Indirect callable concepts
Common algorithm requirements
(C++20)
(C++20)
(C++20)
Utilities
(C++20)
Iterator adaptors
Range access
(C++11) (C++14)
(C++14) (C++14)
(C++11) (C++14)
(C++14) (C++14)
(C++17) (C++20)
(C++17)
(C++17)
ヘッダーで定義 <iterator>
template < class Container >
std:: front_insert_iterator < Container > front_inserter ( Container & c ) ;
(C++20以降 constexpr)

front_inserter は、引数の型から推論された型を持つコンテナ c に対する std::front_insert_iterator を構築する便利な関数テンプレートです。

目次

パラメータ

c - push_front 操作をサポートするコンテナ

戻り値

std::front_insert_iterator は、コンテナ c の先頭に要素を追加するために使用できるイテレータです。

実装例

template<class Container>
std::front_insert_iterator<Container> front_inserter( Container& c )
{
    return std::front_insert_iterator<Container>(c);
}

#include <algorithm>
#include <deque>
#include <iostream>
#include <iterator>
#include <vector>
int main()
{
    std::vector<int> v{1, 2, 3, 4, 5};
    std::deque<int> d;
    std::copy(v.begin(), v.end(), std::front_inserter(d));
    for (int n : d)
        std::cout << n << ' ';
    std::cout << '\n';
}

出力:

5 4 3 2 1

関連項目

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