hash_map::emplace_hint
Hinweis
Diese API ist veraltet.Die Alternative ist unordered_map-Klasse.
Fügt ein Element, das direkt in ein hash_map, mit einem Platzierungshinweis erstellt wird.
template<class ValTy>
iterator emplace_hint(
const_iterator _Where,
ValTy&& _Val
);
Parameter
Parameter |
Beschreibung |
_Val |
Der Wert verwendet, um Konstrukt zu verschieben ein in hash_map-Klasse einzufügende Element, es sei denn, dass hash_map bereits dieses Element enthält (oder, im Allgemeinen, ein Element, dessen Schlüssel gleichwertig sortiert wird). |
_Where |
Ein Hinweis bezüglich des Platzes, an dem mit der Suche nach dem richtigen Einfügepunkt begonnen wird. |
Rückgabewert
Die Memberfunktion hash_multimap::emplace gibt ein Iterator zurück, auf der der Speicherort verweist, an der das neue Element in hash_map eingefügt wurde, oder wenn das vorhandene Element mit entsprechender Reihenfolge befindet.
Hinweise
hash_map::value_type eines Elements ist Paaren, sodass der Wert eines Elements ein Paar geordnetes mit der ersten Komponente gleich den Tastenwert und der zweiten Komponente gleich dem Datenwert des Elements ist.
Einfüge- kann in amortisierter konstanter Zeit, anstelle von logarithmischen Zeitpunkt auftreten, wenn die Einfügemarke direkt _Where folgt.
Ab Visual C++ .NET 2003, sind Member <hash_map> und <hash_set> Headerdateien nicht mehr im std-Namespace, sondern sind in den stdext Namespace verschoben wurde. Weitere Informationen finden Sie unter Der stdext-Namespace.
Beispiel
// hash_map_emplace_hint.cpp
// compile with: /EHsc
#include<hash_map>
#include<iostream>
#include <string>
int main()
{
using namespace std;
using namespace stdext;
hash_map<int, string> hm1;
typedef pair<int, string> is1(1, "a");
hm1.emplace(hm1.begin(), move(is1));
cout << "After the emplace, hm1 contains:" << endl
<< " " << hm1.begin()->first
<< " => " << hm1.begin()->second
<< endl;
}
Anforderungen
Header: <hash_map>
Namespace: stdext