multimap::cbegin() and multimap::cend() in C++ STL

Last Updated : 22 Jun, 2018

multimap::cbegin() is a built-in function in C++ STL which returns a constant iterator referring to the first element in the multimap container. Since multimap container contains the element in an ordered way, cbegin() will point to that element that will come first according to the container’s sorting criterion.

Syntax:

multimap_name.cbegin()

Parameters: The function does not accept any parameter.

Want to learn from the best curated videos and practice problems, check out the C++ Foundation Course for Basic to Advanced C++ and C++ STL Course for foundation plus STL. To complete your preparation from learning a language to DS Algo and many more, please refer Complete Interview Preparation Course.

Return Value: The function returns a constant iterator referring to the first element in the multimap container.

// C++ program to illustrate
// the multimap::cbegin() function
#include <bits/stdc++.h>
using namespace std;
  
int main()
{
  
    // initialize container
    multimap<int, int> mp;
  
    // insert elements in random order
    mp.insert({ 2, 30 });
    mp.insert({ 1, 40 });
    mp.insert({ 3, 60 });
    mp.insert({ 4, 20 });
    mp.insert({ 5, 50 });
  
    auto ite = mp.cbegin();
  
    cout << "The first element is: ";
    cout << "{" << ite->first << ", "
         << ite->second << "}\n";
  
    // prints the elements
    cout << "\nThe multimap is : \n";
    cout << "KEY\tELEMENT\n";
    for (auto itr = mp.cbegin(); itr != mp.cend(); ++itr) {
        cout << itr->first
             << '\t' << itr->second << '\n';
    }
    return 0;
}

Output:

The first element is: {1, 40}

The multimap is : 
KEY    ELEMENT
1    40
2    30
3    60
4    20
5    50

multimap::cend() is a builtin function in C++ STL which returns a constant iterator pointing to the theoretical element that follows last element in the multimap. Since multimap container contains the element in an ordered way, cend() will point to that follows the last element according to the container’s sorting criterion.

Syntax:

multimap_name.cend()

Parameters: The function does not accept any parameter.

Return Value: The function returns a constant iterator pointing to the theoretical element that follows the last element in the multimap.

// C++ program to illustrate
// the multimap::cend() function
#include <bits/stdc++.h>
using namespace std;
  
int main()
{
  
    // initialize container
    multimap<int, int> mp;
  
    // insert elements in random order
    mp.insert({ 2, 30 });
    mp.insert({ 1, 40 });
    mp.insert({ 3, 60 });
    mp.insert({ 4, 20 });
    mp.insert({ 5, 50 });
  
    // print the elements
    cout << "\nThe multimap is : \n";
    cout << "KEY\tELEMENT\n";
    for (auto itr = mp.cbegin(); itr != mp.cend(); ++itr) {
        cout << itr->first
             << '\t' << itr->second << '\n';
    }
    return 0;
}

Output:

The multimap is : 
KEY    ELEMENT
1    40
2    30
3    60
4    20
5    50

My Personal Notes

Related Articles

multimap::cbegin() and multimap::cend() in C++ STL