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

template < class ... Args > void emplace_front ( Args && ... args ) ;		(depuis C++11) (jusqu'à C++17)
template < class ... Args > reference emplace_front ( Args && ... args ) ;		(depuis C++17) (constexpr depuis C++26)

Insère un nouvel élément au début du conteneur. L'élément est construit via std::allocator_traits::construct , qui utilise généralement le placement new pour construire l'élément in-situ à l'emplacement fourni par le conteneur. Les arguments args... sont transmis au constructeur sous la forme std:: forward < Args > ( args ) ... .

Aucun itérateur ou référence n'est invalidé.

Table des matières 1 Paramètres 2 Valeur de retour 3 Complexité 4 Exceptions 5 Voir aussi

Paramètres

args	-	arguments à transmettre au constructeur de l'élément
Exigences de type
- Si T n'est pas EmplaceConstructible dans list à partir de args... , le comportement est indéfini.

Valeur de retour

(aucun)	(jusqu'en C++17)
Une référence à l'élément inséré.	(depuis C++17)

Complexité

Constante.

Exceptions

Si une exception est levée pour quelque raison que ce soit, cette fonction n'a aucun effet ( garantie forte de sûreté face aux exceptions ).

Voir aussi

push_front

insère un élément au début (fonction membre publique)