list::cend
Returns a const iterator that addresses the location succeeding the last element in a list.
const_iterator cend( ) const;
Return Value
A const bidirectional iterator that addresses the location succeeding the last element in a list Class. If the list is empty, then list::cend == list::begin.
Remarks
cend is used to test whether an iterator has reached the end of its list.
Example
// list_cend.cpp
// compile with: /EHsc
#include <list>
#include <iostream>
int main( )
{
using namespace std;
list <int> c1;
list <int>::const_iterator c1_cIter;
c1.push_back( 10 );
c1.push_back( 20 );
c1.push_back( 30 );
c1_cIter = c1.cend( );
c1_cIter--;
cout << "The last integer of c1 is " << *c1_cIter << endl;
}
The last integer of c1 is 30
Requirements
Header: <list>
Namespace: std