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

template < class ... Args > void emplace_front ( Args && ... args ) ;		(начиная с C++11) (до C++17)
template < class ... Args > reference emplace_front ( Args && ... args ) ;		(начиная с C++17) (constexpr начиная с C++26)

Вставляет новый элемент в начало контейнера. Элемент конструируется через std::allocator_traits::construct , который обычно использует placement new для конструирования элемента на месте в локации, предоставленной контейнером. Аргументы args... передаются в конструктор как std:: forward < Args > ( args ) ... .

Никакие итераторы или ссылки не инвалидируются.

Содержание 1 Параметры 2 Возвращаемое значение 3 Сложность 4 Исключения 5 Смотри также

Параметры

args	-	аргументы для передачи конструктору элемента
Требования к типу
- Если T не является EmplaceConstructible в list из args... , поведение не определено.

Возвращаемое значение

(none)	(until C++17)
Ссылка на вставленный элемент.	(since C++17)

Сложность

Константа.

Исключения

Если по какой-либо причине возникает исключение, эта функция не оказывает никакого эффекта ( гарантия строгой безопасности исключений ).

Смотрите также

push_front

вставляет элемент в начало (публичная функция-член)