list::assign

Artikel
03/26/2013

Löscht Elemente aus einer Liste kopiert und einen neuen Satz Elemente zu einer Zielliste.

template<class InputIterator>
   void assign(
      InputIterator _First,
      InputIterator _Last
   );

void assign(
   size_type _Count,
   const Type& _Val
);

Parameter

_First
Position des ersten Elements im Bereich von Elementen, aus der Argumentliste kopiert werden.
_Last
Position des ersten Elements direkt über dem Bereich von Elementen hinaus, aus der Argumentliste kopiert werden.
_Count
Die Anzahl der Kopien eines Elements, das in die Liste eingefügt wird.
_Val
Der Wert des Elements, das in die Liste eingefügt wird.

Hinweise

Nachdem der vorhandenen Elemente in der Zielliste gelöscht haben, fügt assign entweder Einfügungen ein bestimmter Bereich von Elementen aus der ursprünglichen Liste oder von anderen Liste in die Zielliste oder Kopien eines neuen Elements eines angegebenen Werts in die Zielliste ein

Beispiel

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

int main( ) 
{
   using namespace std;
   list<int> c1, c2;
   list<int>::const_iterator cIter;
   
   c1.push_back( 10 );
   c1.push_back( 20 );
   c1.push_back( 30 );
   c2.push_back( 40 );
   c2.push_back( 50 );
   c2.push_back( 60 );

   cout << "c1 =";
   for ( cIter = c1.begin( ); cIter != c1.end( ); cIter++ )
      cout << " " << *cIter;
   cout << endl;

   c1.assign( ++c2.begin( ), c2.end( ) );
   cout << "c1 =";
   for ( cIter = c1.begin( ); cIter != c1.end( ); cIter++ )
      cout << " " << *cIter;
   cout << endl;

   c1.assign( 7, 4 );
   cout << "c1 =";
   for ( cIter = c1.begin( ); cIter != c1.end( ); cIter++ )
      cout << " " << *cIter;
   cout << endl;
}