Emplace a newly constructed element at the front of this deque.

Synopsis

Declared in <bslstl_deque.h>

template<class... Args>
deque<VALUE_TYPE, ALLOCATOR>::reference
emplace_front(Args&&... arguments);

Description

Prepend to the front of this deque 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_TYPE be move‐insertable into this deque and emplace‐constructible from arguments (see {Requirements on VALUE_TYPE}).

Return Value

modifiable reference to the emplaced element

Parameters

Name

Description

arguments

constructor arguments for the new element

Created with MrDocs