C++ Unordered_set::emplace() Function

TheC++ std::unordered_set::emplace() function is used to insert a new element in the unordered_set if its value is unique. The insertion will only takes place if the element does not exists in the unordered_set. when this function is invoked, it insert a new element avoiding the unneccasry copy or move operations.

Syntax

Following is the syntax of std::unordered_set::emplace() function.

pair <iterator,bool> emplace ( Args&&... args );

Parameters

• args − It indicates the arguments passed to the constructor.

Return Value

This function returns an element and a boolean value pair. If the function successfully inserts the element, it returns a pair with an iterator for the newly inserted element and a value of true. If the element to be inserted is already present in the unordered_set, then it returns a pair of iterators pointing to the already-present element and a boolean value of false.

Example 1

Let's look at the following example, where we are going to demonstrate the usage of unordered_set::emplace() function.

#include <iostream>
#include <string>
#include <unordered_set>

int main () {
   std::unordered_set<std::string> myset;

   myset.emplace ("kittu");
   myset.emplace ("prasad");
   myset.emplace ("sairamkrishna");

   std::cout << "myset containing:";
   for (const std::string& x: myset) std::cout << " " << x;

   std::cout << std::endl;
   return 0;
}

Output

Let us compile and run the above program, this will produce the following result −

myset containing: sairamkrishna prasad kittu

Example 2

Consider the following example, where we are going to use the emplace() function and inserting the element that is not present in the unordered_set.

#include <iostream>
#include <string>
#include <unordered_set>
using namespace std;

int main () {
   unordered_set<int> myUset={10, 20};

   myUset.emplace (30);
   myUset.emplace (40);
   myUset.emplace (50);

   cout << "myUset containing:";
   for (const int& x: myUset)
      cout << " " << x;
   cout << endl;
   return 0;
}

Output

If we run the above code it will generate the following output −

myUset containing: 50 40 30 20 10

Example 3

In the following example, we are going to insert the element which was already present in the unordered_set using the emplace() function and observing the output.

#include <iostream>
#include <string>
#include <unordered_set>
using namespace std;

int main () {
   unordered_set<int> myUset={10, 20, 30, 40};

   myUset.emplace (30);
   myUset.emplace (40);

   cout << "myUset containing:";
   for (const int& x: myUset)
      cout << " " << x;
   cout << endl;
   return 0;
}

Output

Following is the output of the above code −

myUset containing: 40 30 20 10

Example 4

Following is the example, where we are going to use the emplace() function and inserting the element into the unordered_set, if the element exists in the unordered_set then it will doesn't make any changes.

#include <iostream>
#include <unordered_set>
using namespace std;
 
int main (){
   unordered_set<int> myUset{10, 20, 30};
 
   auto Insert = myUset.emplace(40);
   if(!Insert.second) 
      cout<<"40 is already present in myUset.\n";
   else
      cout<<"40 is added in myUset.\n";

   Insert = myUset.emplace(20);
   if(!Insert.second) 
      cout<<"20 is already present in myUset.\n";
   else
      cout<<"20 is added in myUset.\n";

   return 0;
}

Output

Output of the above code is as follows −

40 is added in myUset.
20 is already present in myUset.