list::end

Gibt einen Iterator zurück, der den Speicherort abweicht, der dem letzten Element einer Liste.

const_iterator end( ) const;
iterator end( );

Rückgabewert

Ein bidirektionaler Iterator, der den Speicherort abweicht, der dem letzten Element einer Liste.Wenn die Liste leer ist, dann list::end == list::begin.

Hinweise

end wird verwendet, um zu testen, ob ein Iterator das Ende der Liste erreicht wurde.

Beispiel

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

int main( ) 
{
   using namespace std;
   list <int> c1;
   list <int>::iterator c1_Iter;
   
   c1.push_back( 10 );
   c1.push_back( 20 );
   c1.push_back( 30 );

   c1_Iter = c1.end( );
   c1_Iter--;
   cout << "The last integer of c1 is " << *c1_Iter << endl;

   c1_Iter--;
   *c1_Iter = 400;
   cout << "The new next-to-last integer of c1 is "
        << *c1_Iter << endl;

   // If a const iterator had been declared instead with the line:
   // list <int>::const_iterator c1_Iter;
   // an error would have resulted when inserting the 400

   cout << "The list is now:";
   for ( c1_Iter = c1.begin( ); c1_Iter != c1.end( ); c1_Iter++ )
      cout << " " << *c1_Iter;
}
  

Anforderungen

Header: <list>

Namespace: std

Siehe auch

Referenz

list Class

Standardvorlagenbibliothek