multimap::emplace
Vloží prvek vyrobeno na místě (jsou prováděny žádné operace kopírování nebo přesun).
template<class... Args>
iterator emplace(
Args&&... args);
Parametry
Parametr |
Popis |
args |
Argumenty předané vytvořit prvek, který chcete vložit do vícenásobné mapování. |
Vrácená hodnota
Iterace nově vloženého prvku.
Poznámky
Touto funkcí jsou anulovány žádné odkazy na prvky v kontejneru, ale jej může znehodnotit všechny u iterátorů do kontejneru.
Pokud je vyvolána výjimka při vkládání, kontejner zůstane nezměněná a je znovu vyvolány výjimky.
Objekt value_type prvku je objekt pair, takže hodnota prvku bude seřazený pár s první komponentou rovnající se hodnotě klíče a druhou komponentou rovnající se datové hodnotě prvku.
Příklad
// multimap_emplace.cpp
// compile with: /EHsc
#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("Anna", "Accounting");
m1.emplace("Bob", "Accounting");
m1.emplace("Carmine", "Engineering");
cout << "multimap modified, now contains ";
print(m1);
cout << endl;
m1.emplace("Bob", "Engineering");
cout << "multimap modified, now contains ";
print(m1);
cout << endl;
}
Výsledek
multimap modified, now contains 3 elements:
(Anna,Accounting) (Bob,Accounting) (Carmine,Engineering)
multimap modified, now contains 4 elements:
(Anna,Accounting) (Bob,Accounting) (Bob,Engineering) (Carmine,Engineering)
Požadavky
Hlavička: <map>
Obor názvů: std