Namespaces
Variants

std:: front_inserter

From cppreference.net
C++
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)
Definido en el encabezado <iterator>
template < class Container >
std:: front_insert_iterator < Container > front_inserter ( Container & c ) ;
(constexpr desde C++20)

front_inserter es una función plantilla de conveniencia que construye un std::front_insert_iterator para el contenedor c con el tipo deducido a partir del tipo del argumento.

Contenidos

Parámetros

c - contenedor que soporta una operación push_front

Valor de retorno

Un std::front_insert_iterator que puede utilizarse para agregar elementos al principio del contenedor c .

Implementación posible 

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

Ejemplo

Ejecutar este código 
#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';
}

Salida: 

5 4 3 2 1

Véase también

adaptador de iterador para inserción al frente de un contenedor
(plantilla de clase)
crea un std::back_insert_iterator del tipo inferido del argumento
(plantilla de función)
crea un std::insert_iterator del tipo inferido del argumento
(plantilla de función)