Freigeben über


hash_multimap::emplace_hint

Hinweis

Diese API ist veraltet.Die Alternative ist unordered_multimap-Klasse.

Fügt ein Element, das direkt in ein hash_multimap, 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_multimap-Klasse einzufügende Element, es sei denn, dass hash_multimap 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_multimap eingefügt wurde.

Hinweise

hash_multimap::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_multimap_emplace_hint.cpp
// compile with: /EHsc
#include<hash_multimap>
#include<iostream>
#include <string>

int main()
{
    using namespace std;
    using namespace stdext;
    hash_multimap<int, string> hm1;
    typedef pair<int, string> is1(1, "a");

    hm1.emplace(hm1.begin(), move(is1));
    cout << "After the emplace insertion, hm1 contains:" << endl
      << " " << hm1.begin()->first
      << " => " << hm1.begin()->second
      << endl;
}
  

Anforderungen

Header: <hash_map>

Namespace: stdext

Siehe auch

Referenz

hash_multimap-Klasse

Standardvorlagenbibliothek