Insert numElements copies of value before position.

Synopsis

Declared in <bslstl_deque.h>

deque<VALUE_TYPE, ALLOCATOR>::iterator
insert(
    const_iterator position,
    size_type numElements,
    VALUE_TYPE const& value);

Description

Insert at the specified position in this deque the specified numElements copies of the specified value, and return an iterator providing modifiable access to the first element in the newly inserted sequence of elements. This method offers full guarantee of rollback in case an exception is thrown other than by the VALUE_TYPE copy constructor or assignment operator. This method requires that the (template parameter) VALUE_TYPE be copy‐insertable into this deque (see {Requirements on VALUE_TYPE}). The behavior is undefined unless position is an iterator in the range [cbegin() .. cend()] (both endpoints included).

Return Value

iterator to the first inserted element

Parameters

Name

Description

position

iterator before which to insert

numElements

number of copies to insert

value

value to copy‐insert

Created with MrDocs