std::forward_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) |
Вставляет новый элемент в начало контейнера. Элемент создаётся с помощью std::allocator_traits::construct, что обычно использует placement-new для создания элемента на месте в позиции, предоставленной контейнером. Аргументы args... передаются в конструктор как std::forward<Args>(args)....
Никакие итераторы или ссылки не делают недействительными.
Параметры
| args | - | аргументы для передачи в конструктор элемента |
| Требования к типу | ||
-T (the container's element type) должен соответствовать требованиям EmplaceConstructible. |
||
Возвращаемое значение
| (ничего) | (до C++17) |
| Ссылка на вставленный элемент. | (с C++17) |
Сложность
Постоянная.
Исключения
Если брошено исключение по какой-либо причине, эта функция не оказывает никакого эффекта (гарантия сильной защиты от исключений).
См. также
| вставляет элемент в начало (публичный член-функция) |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/container/forward_list/emplace_front
