Sdílet prostřednictvím


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

Viz také

Referenční dokumentace

<map>

multimap – třída

Standardní knihovna šablon