hash_multimap::insert
Hinweis
Diese API ist veraltet.Die Alternative ist unordered_multimap-Klasse.
Fügt ein Element oder einen Elementbereich in ein hash_multimap-Element ein.
iterator insert(
const value_type& Val
);
iterator insert(
const_iterator Where,
const value_type& Val
);
void insert(
initializer_list<value_type> IList
);
template<class InputIterator>
void insert(
InputIterator First,
InputIterator Last
);
template<class ValTy>
iterator insert(
ValTy&& Val
);
template<class ValTy>
iterator insert(
const_iterator Where,
ValTy&& Val
);
Parameter
Parameter |
Beschreibung |
Val |
Der Wert eines in das hash_multimap-Element einzufügenden Elements, es sei denn, das Element ist bereits enthalten oder, üblicher, es sei denn, ein Element, dessen Schlüssel gleichwertig sortiert wird, ist bereits enthalten. |
Where |
Ein Hinweis darüber, wo mit der Suche nach den richtigen Einfügepunkt begonnen wird. |
First |
Die Position des ersten Elements, das aus einer Zuordnung kopiert werden soll. |
Last |
Die Position direkt über den letzten aus einer Zuordnung zu kopierenden Elements. |
Rückgabewert
Die ersten zwei insert-Memberfunktionen geben ein Iterator zurück, der auf den Speicherort zeigt, an dem das neue Element eingefügt wurde.
Die dritte Memberfunktion verwendet ein initializer_list-Element, damit die Elemente eingefügt werden können.
Die vierte Memberfunktion fügt die Sequenz von Elementwerten in eine Zuordnung ein, die jedem Element entspricht, das von einem Iterator im [First, Last)-Bereich einer bestimmten Gruppe adressiert wird.
Die letzten zwei insert-Memberfunktionen verhalten sich identisch zu den ersten beiden, außer dass der eingefügte Wert durch Verschiebung erstellt wird.
Hinweise
Der value_type eines Elements wird paarweise angegeben, sodass der Wert eines Elements ein sortiertes Paar ist, in dem die erste Komponente gleich dem Schlüsselwert und die zweite Komponente gleich dem Datenwert des Elements ist.
Die Einfügung kann für die Hinweisversion von insert in amortisierter konstanter Zeit anstelle von logarithmischer Zeit erfolgen, wenn die Einfügemarke Where direkt folgt.
Anforderungen
Header: <hash_map>
Namespace: stdext