bsl::list::insert

Insert the values from values at the specified dstPosition.

Synopsis

Declared in <bslstl_list.h>

list<VALUE, ALLOCATOR>::iterator
insert(
    const_iterator dstPosition,
    std::initializer_list<value_type> values);

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

NameDescription
dstPositionlocation before which elements are inserted
valuesinitializer list of values to insert