map::emplace
Wstawia element zbudowanych w miejscu do mapy.
template<class ValTy>
pair<iterator, bool> emplace(
ValTy&& _Val
);
Parametry
Parametr |
Opis |
_Val |
Wartość elementu wstawiane do map Class chyba że map zawiera już tego elementu lub bardziej ogólnie, element, której klucz jest równoważnie zamówione. |
Wartość zwracana
emplace Członkowskie, funkcja zwraca parę, którego składnik bool zwraca wartość true, jeśli wstawiania, a false jeśli map zawierał element, w której klucz miał równoważnej wartości w kolejności i którego składnik iteratora zwraca adres, gdy nowy element został wstawiony lub gdy element został już znajduje.
Składnik iteratora parę dostępu do pr zwracana przez tę funkcję Członkowskich, użyj pr.firsti aby do niego, użyj *(pr.first).Dostęp bool składnik parę pr zwracana przez tę funkcję Członkowskich, użyj pr.second.
Uwagi
Value_type elementu jest para, tak aby wartość elementu pary, z pierwszego składnika równego wartości klucza i drugi element równy wartości danych elementu.
Przykład
// map_emplace.cpp
// compile with: /EHsc
#include <map>
#include <iostream>
#include <string>
int main( ) {
using namespace std;
map<int, string> m1;
pair<int, string> is1(1, "a");
m1.emplace(move(is1));
cout << "After the emplace insertion, m1 contains:" << endl
<< " " << m1.begin()->first
<< " => " << m1.begin()->second
<< endl;
}
Dane wyjściowe
After the emplace insertion, m1 contains:
1 => a
Wymagania
Nagłówek: <map>
Obszar nazw: std