map::emplace
Inserire un elemento costruito sul posto in un mapping.
template<class ValTy>
pair<iterator, bool> emplace(
ValTy&& _Val
);
Parametri
Parametro |
Descrizione |
_Val |
Il valore di un elemento da inserire in map Class a meno che map già contenere più generale tale elemento, o, un elemento il cui la chiave equivalente è ordinata. |
Valore restituito
La funzione membro emplace restituisce una coppia di cui il componente di bool restituisce true se un inserimento sia stato scelto e false se map già contiene un elemento il cui la chiave ha un valore equivalente in ordine e di cui il componente iteratori restituisce l'indirizzo dove un nuovo elemento è stato inserito o in cui l'elemento è già stato individuato.
Per accedere al componente iteratore di una coppia pr restituito dalla funzione membro, utilizzare pr.firste per dereferenziarla, utilizzare *(pr.first).Per accedere al componente bool di una coppia pr restituito dalla funzione membro, utilizzare pr.second.
Note
value_type di un elemento rappresenta una coppia, in modo che il valore di un elemento verrà una coppia ordinata con la prima parte uguale al valore della chiave e la seconda parte uguale al valore dei dati dell'elemento.
Esempio
// 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;
}
Output
After the emplace insertion, m1 contains:
1 => a
Requisiti
intestazione: <map>
Spazio dei nomi: deviazione standard