Skip to content

Search topics & cppreference

Search all study topics, concept maps, and 6,587 C++ and C reference pages.

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

Inserts a new element to the beginning of the container. The element is constructed through std::allocator_traits::construct, which typically uses placement-new to construct the element in-place at the location provided by the container.

Containers
  • C++11
  • C++17
1 min readView on cppreference
NotebookLM
template< class... Args >
void emplace_front( Args&&... args );
(since C++11)
(until C++17)
template< class... Args >
reference emplace_front( Args&&... args );
(since C++17)

Inserts a new element to the beginning of the container. The element is constructed through std::allocator_traits::construct, which typically uses placement-new to construct the element in-place at the location provided by the container. The arguments args... are forwarded to the constructor as std::forward<Args>(args)....

No iterators or references are invalidated.

Parameters

args - arguments to forward to the constructor of the element
Type requirements
T (the container's element type) must meet the requirements of EmplaceConstructible.

Return value

(none) (until C++17)
A reference to the inserted element. (since C++17)

Complexity

Constant.

Exceptions

If an exception is thrown for any reason, this function has no effect (strong exception safety guarantee).

See also

inserts an element to the beginning
(public member function)

Content from this page on cppreference.com, licensed under CC-BY-SA 3.0 and GFDL. Modified: restyled, site navigation removed, code windows added. Offline snapshot of 9 February 2025.