C++ multimap emplace() function

The C++ multimap emplace() function is used to extend the multimap container by inserting new elements into the container. Elements are built directly (neither copied nor moved).

The constructor of the element is called by giving the arguments args passed to this function.

Syntax

template <class... Args>
    iterator emplace (Args&&... args);    //since C++ 11

Parameter

args: The arguments forwarded to construct an element to be inserted into the multimap.

Return value

The C++ emplace() function indicates if the insertion is occurred or not and returns an iterator pointing to the newly inserted element.

Complexity

Logarithmic in the container size.

Iterator validity

No changes.

Data races

The container is modified.

Iterating ranges in the container is not safe although concurrently accessing exiting elements is safe.

Exception Safety

If an exception is thrown, there are no changes in the container.

Example 1

Let's see the simple example to insert the elements into the multimap:

#include <iostream>
#include <map>

using namespace std;

int main(void) {
   
   multimap<char, int> m;

   m.emplace('a', 1);
   m.emplace('b', 2);
   m.emplace('c', 3);
   m.emplace('b', 4);
   m.emplace('c', 5);

   cout << "Multimap contains following elements" << endl;

   for (auto it = m.begin(); it != m.end(); ++it)
      cout << it->first << " = " << it->second << endl;

   return 0;
}

Output:

Multimap contains following elements
a = 1
b = 2
b = 4
c = 3
c = 5

In the above example, it simply insert the element into the multimap m with the given key value pairs.

Example 2

Let's see a simple example to insert the element and check whether the duplicate key is allowed in multimap or not:

#include <map>  
#include <string>  
#include <iostream>  
  
using namespace std;  
  
template <typename M> void print(const M& m) {  
    cout << m.size() << " elements: " << endl;  
  
    for (const auto& p : m) {  
        cout << "(" << p.first <<  "," << p.second << ") ";  
    }  
  
    cout << endl;  
}  
  
int main()  
{  
    multimap<string, string> m1;  
  
    m1.emplace("Nikita", "Accounting");  
    m1.emplace("Amita", "Accounting");  
    m1.emplace("Deep", "Engineering");  
  
    cout << "multimap modified, now contains ";  
    print(m1);  
    cout << endl;  
  
    m1.emplace("Nikita", "Engineering");  
  
    cout << "multimap modified, now contains ";  
    print(m1);  
    cout << endl;  
}

Output:

multimap modified, now contains 3 elements: 
(Amita,Accounting) (Deep,Engineering) (Nikita,Accounting) 

multimap modified, now contains 4 elements: 
(Amita,Accounting) (Deep,Engineering) (Nikita,Accounting) (Nikita,Engineering)

In the above example, elements are inserted in the multimap and when you try to add the same key Nikita then it will allow you to insert duplicates.

Example 3

Let's see a simple example to insert the elements into the multimap by passing a constructor argument to a key and a value respectively:

#include <iostream>
#include <utility>
#include <string>
#include <map>
 
using namespace std;

int main()
{
    multimap<string, string> m;
 
    // uses pair's move constructor
    m.emplace(make_pair(string("a"), string("a")));
 
    // uses pair's converting move constructor
    m.emplace(make_pair("b", "abcd"));
 
    // uses pair's template constructor
    m.emplace("a", "aaa");
 
    // uses pair's piecewise constructor
    m.emplace(piecewise_construct,
              forward_as_tuple("c"),
              forward_as_tuple(10, 'c'));
 
    for (const auto &p : m) {
        cout << p.first << " => " << p.second << '\n';
    }
}

Output:

a => a
a => aaa
b => abcd
c => cccccccccc

In the above example, elements are inserted into the multimap by passing a constructor argument to a key and a value respectively.

Example 4

Let's see a simple example to insert the element:

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

int main() {

  typedef multimap<string, int> city;  
   string name;
   int age;
   city fmly ;
   int n;

   cout<<"Enter the number of fmly members :";
   cin>>n;

   cout<<"Enter the name and age of each member: \n";
   for(int i =0; i<n; i++)
   {
       cin>> name;      // Get key
       cin>> age;    // Get value
       fmly.emplace(name,age); // Put them in multimap
       
   }
   
      cout<<"\nTotal memnber of fmly is:"<< fmly.size();

      cout<<"\nDetails of fmly members: \n";
      cout<<"\nName  |  Age \n ________________________\n";
      city::iterator p;
      for(p = fmly.begin(); p!=fmly.end(); p++)
      {
          cout<<(*p).first << " | " <<(*p).second <<" \n ";
      }
    
   return 0;
}

Output:

Enter the number of fmly members : 3
Enter the name and age of each member: 
Ram 42
Sita 37
Laxman 40

Total memnber of fmly is:3
Details of fmly members: 

Name    |  Age 
__________________________
Laxman | 40 
Ram      | 42 
Sita       | 37

In the above example, it simply inserts the elements by the user's choice.

Next TopicC++ multimap

← prev next →