multimap::cbegin
Returns a const iterator addressing the first element in the multimap.
const_iterator cbegin( ) const;
Return Value
A const bidirectional iterator addressing the first element in the multimap Class or the location succeeding an empty multimap.
Remark
With the return value of cbegin, the elements in the multimap object cannot be modified.
Example
// multimap_cbegin.cpp
// compile with: /EHsc
#include <map>
#include <iostream>
int main( )
{
using namespace std;
multimap <int, int> m1;
multimap <int, int> :: const_iterator m1_cIter;
typedef pair <int, int> Int_Pair;
m1.insert ( Int_Pair ( 0, 0 ) );
m1.insert ( Int_Pair ( 1, 1 ) );
m1.insert ( Int_Pair ( 2, 4 ) );
m1_cIter = m1.cbegin ( );
cout << "The first element of m1 is " << m1_cIter -> first << endl;
}
The first element of m1 is 0
Requirements
Header: <map>
Namespace: std