map::emplace
Fügt ein Element ein, das direkt in eine Zuordnung erstellt wird.
template<class ValTy>
pair<iterator, bool> emplace(
ValTy&& _Val
);
Parameter
Parameter |
Description |
_Val |
Der Wert eines in map Class einzufügende Elements, es sei denn, map bereits dieses Element oder, im Allgemeinen, ein Element enthält, dessen Schlüssel gleichwertig sortiert wird. |
Rückgabewert
Die emplace-Memberfunktion gibt ein Paar zurück, dessen bool Komponentenrückgaben ausrichten, wenn eine Einfügung und false ausgeführt wurde, wenn map bereits ein Element enthält, dessen Schlüssel einen ein in der Reihenfolge verfügt und dessen Iteratorkomponente die Adresse zurückgibt, in der ein neues Element eingefügt wurde, oder der das Element bereits gefunden wurde.
Um auf die Iteratorkomponente eines Paars pr zuzugreifen, das von dieser Memberfunktion zurückgegeben wird, verwenden Sie pr.first, und sie zu dereferenzieren, Verwendung *(pr.first).Um auf die bool Komponente eines Paars pr zuzugreifen, das von dieser Memberfunktion zurückgegeben wird, verwenden Sie pr.second.
Hinweise
value_type eines Elements ist Paaren, sodass der Wert eines Elements ein geordnetes Paar mit der ersten Komponente gleich dem Schlüsselwert und der zweiten Komponente gleich den Datenwert des Elements ist.
Beispiel
// 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
Anforderungen
Header: <map>
Namespace: std