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 ) ... .
Никакие итераторы или ссылки не инвалидируются.
Содержание |
Параметры
| args | - | аргументы для передачи конструктору элемента |
| Требования к типу | ||
-
T
не является
EmplaceConstructible
в
list
из
args...
, поведение не определено.
|
||
Возвращаемое значение
| (none) | (until C++17) |
| Ссылка на вставленный элемент. | (since C++17) |
Сложность
Константа.
Исключения
Если по какой-либо причине возникает исключение, эта функция не оказывает никакого эффекта ( гарантия строгой безопасности исключений ).
Смотрите также
|
вставляет элемент в начало
(публичная функция-член) |