front_inserter

Damit wird ein Iterator erstellt, mit dem Elemente an den Anfang eines bestimmten Containers eingefügt werden können.

template<class Container> 
   front_insert_iterator<Container> front_inserter( 
      Container& _Cont 
   );

Parameter

• _Cont
  Das Containerobjekt, dessen Vordergrund eingefügtes ein Element verfügt.

Rückgabewert

front_insert_iterator dem Containerobjekt _Cont.

Hinweise

Die Memberfunktion front_insert_iterator der front_insert_iterator Klasse kann ebenfalls verwendet werden.

Innerhalb der Standardvorlagenbibliothek muss das Argument einen der beiden Sequenzcontainer zugreifen, die die Memberfunktion push_back haben: Doppelschlange Klasse oder Liste Klasse.

Beispiel

// iterator_front_inserter.cpp
// compile with: /EHsc
#include <iterator>
#include <list>
#include <iostream>

int main( )
{
   using namespace std;
   int i;
   list <int>::iterator L_Iter;

   list<int> L;
   for ( i = -1 ; i < 9 ; ++i )
   {
      L.push_back ( i );
   }

   cout << "The list L is:\n ( ";
   for ( L_Iter = L.begin( ) ; L_Iter != L.end( ); L_Iter++)
      cout << *L_Iter << " ";
   cout << ")." << endl;

   // Using the template function to insert an element
   front_insert_iterator< list < int> > Iter(L);
   *Iter = 100;

   // Alternatively, you may use the front_insert member function
   front_inserter ( L ) = 200;

   cout << "After the front insertions, the list L is:\n ( ";
   for ( L_Iter = L.begin( ) ; L_Iter != L.end( ); L_Iter++)
      cout << *L_Iter << " ";
   cout << ")." << endl;
}

Anforderungen

Header: <Iterator>

Namespace: std

Siehe auch

Referenz

Standardvorlagenbibliothek