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) |
Вставляет новый элемент в начало контейнера. Элемент конструируется с помощью std::allocator_traits::construct, который обычно использует размещающий 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/list/emplace_front
