multimap::emplace_hint
Fügt ein Element ein, das direkt in eine Zuordnung, mit einem Platzierungs-Hinweis erstellt wird.
template<class ValTy>
pair<iterator, bool> emplace_hint(
const_iterator _Where,
ValTy&& _Val
);
Parameter
Parameter |
Description |
_Val |
Der Wert eines in multimap Class einzufügende Elements, es sei denn, multimap bereits dieses Element oder, im Allgemeinen, ein Element enthält, dessen Schlüssel gleichwertig sortiert wird. |
_Where |
Ein Hinweis hinsichtlich des Position, an der das Suchen für den richtigen Punkt der Einfügung zu starten. |
Rückgabewert
Die multimap::emplace-Memberfunktion gibt ein Paar zurück, dessen bool Komponentenrückgaben ausrichten, wenn eine Einfügung und false ausgeführt wurde, wenn die Zuordnung 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
multimap::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
// multimap_emplace_hint.cpp
// compile with: /EHsc
#include <map>
#include <iostream>
#include <string>
int main( ) {
using namespace std;
multimap<int, string> m1;
pair<int, string> is1(1, "a");
m1.emplace(m1.begin(), 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