std::multiset<Key,Compare,Allocator>:: emplace_hint

template < class ... Args > iterator emplace_hint ( const_iterator hint, Args && ... args ) ;		(seit C++11) (constexpr seit C++26)

Fügt ein neues Element so nah wie möglich an die Position direkt vor hint in den Container ein.

Die Konstruktoren des Schlüssels und des zugeordneten Werts werden mit exakt denselben Argumenten aufgerufen, die der Funktion übergeben wurden, weitergeleitet mit std:: forward < Args > ( args ) ... .

Keine Iteratoren oder Referenzen werden ungültig.

Inhaltsverzeichnis 1 Parameter 2 Rückgabewert 3 Ausnahmen 4 Komplexität 5 Beispiel 6 Siehe auch

Parameter

hint	-	Iterator auf die Position, vor der das neue Element eingefügt wird
args	-	Argumente, die an den Konstruktor des Elements weitergeleitet werden

Rückgabewert

Ein Iterator auf das eingefügte Element.

Ausnahmen

Wenn aus irgendeinem Grund eine Exception ausgelöst wird, hat diese Funktion keine Wirkung ( strong exception safety guarantee ).

Komplexität

Logarithmisch in der Größe des Containers im Allgemeinen, aber amortisiert konstant, wenn das neue Element direkt vor hint eingefügt wird.

Beispiel

Dieser Abschnitt ist unvollständig Grund: Kein Beispiel

Siehe auch

emplace (C++11)	Konstruiert Elemente direkt (öffentliche Elementfunktion)
insert	Fügt Elemente ein oder Knoten (seit C++17) (öffentliche Elementfunktion)