bsl::list::emplace_front

Prepend to the front of this list a newly created value_type object, constructed by forwarding get_allocator() (if required) and the specified (variable number of) arguments to the corresponding constructor of value_type. Return a reference providing modifiable access to the inserted element. If an exception is thrown (other than by the move constructor of a non-copy-insertable value_type), this method has no effect. This method requires that the (template parameter) VALUE be move-insertable into this list and emplace-constructible from arguments (see {Requirements on VALUE}).

Synopsis

Declared in <bslstl_list.h>

template<class... ARGS>
list<VALUE, ALLOCATOR>::reference
emplace_front(ARGS&&... arguments);