Standard C++ Library Class Reference

Returns *this (the input iterator itself).
front_insert_iterator<Container>&
operator++ ();
front_insert_iterator<Container>
operator++ (int);
Increments the insert iterator and returns *this.
Non-member Function
template <class Container>
front_insert_iterator<Container>
front_inserter (Container& x)
Returns a front_insert_iterator that will insert elements at the beginning of container x.
This function allows you to create front insert iterators inline.
Example
//
// ins_itr.cpp
//
#include <iterator>
#include <deque>
#include <iostream.h>
int main ()
{
//
// Initialize a deque using an array.
//
int arr[4] = { 3,4,7,8 };
deque<int> d(arr+0, arr+4);
//
// Output the original deque.
//
cout << "Start with a deque: " << endl << " ";
copy(d.begin(), d.end(), ostream_iterator<int>(cout," "));
//
// Insert into the middle.
//
insert_iterator<deque<int> > ins(d, d.begin()+2);
*ins = 5; *ins = 6;
//
// Output the new deque.
//