The following code example is taken from the book
The C++ Standard Library - A Tutorial and Reference, 2nd Edition
by Nicolai M. Josuttis, Addison Wesley Longman, 2012
Copyright © 2012 by Pearson Education, Inc. and Nicolai M. Josuttis
#include <list>
#include <algorithm>
#include <iterator>
#include "print.hpp"
using namespace std;
int main()
{
list<int> coll;
// create front inserter for coll
// - inconvenient way
front_insert_iterator<list<int> > iter(coll);
// insert elements with the usual iterator interface
*iter = 1;
iter++;
*iter = 2;
iter++;
*iter = 3;
PRINT_ELEMENTS(coll);
// create front inserter and insert elements
// - convenient way
front_inserter(coll) = 44;
front_inserter(coll) = 55;
PRINT_ELEMENTS(coll);
// use front inserter to insert all elements again
copy (coll.begin(), coll.end(), // source
front_inserter(coll)); // destination
PRINT_ELEMENTS(coll);
}