Skip to content
Related Articles

Related Articles

Improve Article

unordered_multimap emplace_hint() function in C++ STL

  • Last Updated : 08 Aug, 2018

The unordered_multimap::emplace_hint() is a built-in function in C++ STL which inserts a new {key:element} in the unordered_multimap container. It starts searching from the position provided in the parameter for the insertion point of the element. The position only acts as a hint, it does not decide the position at which the insertion is to be done. The insertion is done automatically at the position according to the container’s criterion. It increases the size of the container by one.

Syntax:

unordered_multimap_name.emplace_hint(iterator position, key, element)

Parameters: The function accepts three mandatory parameters which are described below:

  • position: it specifies the iterator pointing to the position from where search operation for insertion is to be started.
  • key: it specifies the key which is to be inserted in the container.
  • element: it specifies the element which is to be inserted in the container

Return Value: It returns an iterator which points to the newly inserted element.

Below programs illustrates the above function:



Program 1:




// C++ program to illustrate
// unordered_multimap::emplace_hint()
#include <iostream>
#include <string>
#include <unordered_map>
using namespace std;
  
int main()
{
  
    // declaration
    unordered_multimap<int, int> sample;
  
    // inserts key and element in a faster
    // way as hint given is correct
    auto it = sample.emplace_hint(sample.begin(), 1, 2);
    it = sample.emplace_hint(it, 1, 2);
    it = sample.emplace_hint(it, 1, 3);
  
    // slower methods as wrong position
    // has beeen given to start
    sample.emplace_hint(sample.begin(), 4, 9);
    sample.emplace_hint(sample.begin(), 60, 89);
  
    std::cout << "Key and elements:\n";
    for (auto it = sample.begin(); it != sample.end(); it++)
        cout << "{" << it->first << ":" << it->second << "}\n ";
  
    std::cout << std::endl;
    return 0;
}
Output:
Key and elements:
{60:89}
 {4:9}
 {1:2}
 {1:2}
 {1:3}

Program 2:




// C++ program to illustrate
// unordered_multimap::emplace_hint()
#include <iostream>
#include <string>
#include <unordered_map>
using namespace std;
  
int main()
{
  
    // declaration
    unordered_multimap<string, string> sample;
  
    // inserts elements in a faster way as
    // hint given is correct
    auto it = sample.emplace_hint(sample.begin(), "gopal", "dave");
    it = sample.emplace_hint(it, "gopal", "dave");
    it = sample.emplace_hint(it, "Geeks", "Website");
  
    // slower methods as wrong position
    // has beeen given to start
    sample.emplace_hint(sample.begin(), "Geeks", "STL");
    sample.emplace_hint(sample.begin(), "Multimap", "functions");
  
    std::cout << "Key and elements:\n";
    for (auto it = sample.begin(); it != sample.end(); it++)
        cout << "{" << it->first << ":" << it->second << "}\n ";
  
    std::cout << std::endl;
    return 0;
}
Output:
Key and elements:
{Multimap:functions}
 {Geeks:Website}
 {Geeks:STL}
 {gopal:dave}
 {gopal:dave}
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.



My Personal Notes arrow_drop_up
Recommended Articles
Page :