Prepend a newly constructed value_type object to the front of this list.

Synopsis

Declared in <bslstl_list.h>

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

Description

The object is 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}).

Return Value

modifiable reference to the emplaced element

Parameters

Name

Description

arguments

constructor arguments forwarded to value_type

Created with MrDocs