map::emplace
Insère un élément construit en place dans une carte.
template<class ValTy>
pair<iterator, bool> emplace(
ValTy&& _Val
);
Paramètres
Paramètre |
Description |
_Val |
La valeur d'un élément à insérer dans map Class à moins qu' map contienne déjà cet élément ou, plus généralement, un élément dont la clé est de façon équivalente classée. |
Valeur de retour
La fonction membre d' emplace retourne une paire de le composant de bool retourne la valeur true si une insertion a été faite et false si map contenait déjà un élément dont la clé a eu une valeur équivalente dans l'ordre, et dont le composant itérateur retourne l'adresse où un nouvel élément a été inséré ou lorsque l'élément a déjà été localisé.
Pour accéder au composant d'itérateur d'une paire pr retourné par cette fonction membre, utilisez pr.first, et le déréférencement, utilisez *(pr.first).Pour accéder au composant d' bool d'une paire pr retourné par cette fonction membre, utilisez pr.second.
Notes
value_type d'un élément sont des paires, afin que la valeur d'un élément soit une paire triée de le premier composant égale à la valeur de la clé et le deuxième composant égale à la valeur de données de l'élément.
Exemple
// 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;
}
Sortie
After the emplace insertion, m1 contains:
1 => a
Configuration requise
en-tête : <map>
l'espace de noms : DST