list::end
Returns an iterator that addresses the location succeeding the last element in a list.
const_iterator end( ) const;
iterator end( );
Return Value
A bidirectional iterator that addresses the location succeeding the last element in a list. If the list is empty, then list::end == list::begin.
Remarks
end is used to test whether an iterator has reached the end of its list.
Example
// 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;
}
Output
The last integer of c1 is 30
The new next-to-last integer of c1 is 400
The list is now: 10 400 30
Requirements
Header: <list>
Namespace: std