std::list<T,Allocator>:: emplace_front

template < class ... Args > void emplace_front ( Args && ... args ) ;		(seit C++11) (bis C++17)
template < class ... Args > reference emplace_front ( Args && ... args ) ;		(seit C++17) (constexpr seit C++26)

Fügt ein neues Element am Anfang des Containers ein. Das Element wird durch std::allocator_traits::construct konstruiert, was typischerweise Placement- new verwendet, um das Element direkt an der vom Container bereitgestellten Position zu konstruieren. Die Argumente args... werden an den Konstruktor als std:: forward < Args > ( args ) ... weitergeleitet.

Keine Iteratoren oder Referenzen werden ungültig.

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

Parameter

args	-	Argumente, die an den Konstruktor des Elements weitergeleitet werden
Typanforderungen
- Wenn T nicht EmplaceConstructible in list aus args... ist, ist das Verhalten undefiniert.

Rückgabewert

(none)	(until C++17)
Ein Verweis auf das eingefügte Element.	(since C++17)

Komplexität

Konstante.

Exceptions

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

Siehe auch

push_front

Fügt ein Element am Anfang ein (öffentliche Elementfunktion)