C++ Map Library - insert() Function



Description

The C++ function std::multimap::insert() extends container by inserting new elements in the multimap.

Declaration

Following is the declaration for std::multimap::insert() function form std::map header.

C++98

template <class InputIterator>
void insert (InputIterator first, InputIterator last);

C++11

template <class InputIterator>
void insert (InputIterator first, InputIterator last);

Parameters

  • first − Input iterator to the initial position in range.

  • last − Input iterator to the final position in range.

Return value

None

Exceptions

No effect on container if exception is thrown.

Time complexity

Logarithmic i.e. O(log n)

Example

The following example shows the usage of std::multimap::insert() function.

#include <iostream>
#include <map>

using namespace std;

int main(void) {
   /* Multimap with duplicates */
   multimap<char, int> m1 {
            {'a', 1},
            {'a', 2},
            {'b', 3},
            {'c', 4},
            {'d', 5}
         };

   multimap<char, int> m2;

   m2.insert(m1.begin(), m1.end());

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

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

   return 0;
}

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

Multimap contains the following elements:
a = 1
a = 2
b = 3
c = 4
d = 5
map.htm
Advertisements