Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Returns an iterator that addresses the ___location succeeding the last element in a multimap.
const_iterator end( ) const;
iterator end( );
Return Value
A bidirectional iterator that addresses the ___location succeeding the last element in a multimap. If the multimap is empty, then multimap::end == multimap::begin.
Remarks
end is used to test whether an iterator has reached the end of its multimap.
The value returned by end should not be dereferenced.
Example
// multimap_end.cpp
// compile with: /EHsc
#include <map>
#include <iostream>
int main( )
{
using namespace std;
multimap <int, int> m1;
multimap <int, int> :: iterator m1_Iter;
multimap <int, int> :: const_iterator m1_cIter;
typedef pair <int, int> Int_Pair;
m1.insert ( Int_Pair ( 1, 10 ) );
m1.insert ( Int_Pair ( 2, 20 ) );
m1.insert ( Int_Pair ( 3, 30 ) );
m1_cIter = m1.end( );
m1_cIter--;
cout << "The value of last element of m1 is "
<< m1_cIter -> second << endl;
m1_Iter = m1.end( );
m1_Iter--;
m1.erase ( m1_Iter );
// The following 2 lines would err because the iterator is const
// m1_cIter = m1.end ( );
// m1_cIter--;
// m1.erase ( m1_cIter );
m1_cIter = m1.end( );
m1_cIter--;
cout << "The value of last element of m1 is now "
<< m1_cIter -> second << endl;
}
The value of last element of m1 is 30 The value of last element of m1 is now 20
Requirements
Header: <map>
Namespace: std