Insert numElements copies of value at dstPosition.

Synopsis

Declared in <bslstl_list.h>

list<VALUE, ALLOCATOR>::iterator
insert(
    const_iterator dstPosition,
    size_type numElements,
    value_type const& value);

Description

Return an iterator providing modifiable access to the first element in the newly inserted sequence of elements. This method requires that the (template parameter) VALUE be copy‐insertable into this list (see {Requirements on VALUE}). The behavior is undefined unless dstPosition is an iterator in the range [cbegin() .. cend()] (both endpoints included).

Return Value

iterator to the first inserted element, or dstPosition if empty

Parameters

Name

Description

dstPosition

location before which elements are inserted

numElements

number of copies of value to insert

value

value copied into each inserted element

Created with MrDocs