std::list::emplace_front

From cppreference.com
< cpp‎ | container‎ | list

template< class... Args >
void emplace_front( Args&&... args );
(since C++11)

Inserts a new element to the beginning of the container. The element is constructed in-place, i.e. no copy or move operations are performed. The constructor of the element is called with exactly the same arguments, as supplied to the function.

No iterators or references are invalidated.

Contents

[edit] Parameters

args - arguments to forward to the constructor of the element

[edit] Return value

(none)

[edit] Complexity

Constant.

[edit] Exceptions

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

[edit] See also

inserts elements to the beginning
(public member function)