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/cpp/container/forward_list/emplace_front
