std::multimap::emplace

Parameters

args

Arguments used to construct a new object of the mapped type for the inserted element.

Arguments forwarded to construct the new element (of type pair<const key_type, mapped_type>).
This can be one of:
- Two arguments: one for the key, the other for the mapped value.
- A single argument of a pair type with a value for the key as first member, and a value for the mapped value as second.
- piecewise_construct as first argument, and two additional arguments with tuples to be forwarded as arguments for the key value and for the mapped value respectivelly.
See pair::pair for more info.

Return value

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

// multimap::emplace
#include <iostream>
#include <string>
#include <map>
int main ()
{
  std::multimap<std::string,float> mymultimap;
  mymultimap.emplace("apple",1.50);
  mymultimap.emplace("coffee",2.10);
  mymultimap.emplace("apple",1.40);
  std::cout << "mymultimap contains:";
  for (auto& x: mymultimap)
    std::cout << " [" << x.first << ':' << x.second << ']';
  std::cout << '\n';
  return 0;
}

mymultimap contains: [apple:1.5] [apple:1.4] [coffee:2.1]

Complexity

Iterator validity

Data races

Exception safety

See also

multimap::emplace_hint

Construct and insert element with hint (public member function)

multimap::insert

Insert element (public member function)

multimap::erase

Erase elements (public member function)