Insert a copy of value at dstPosition and return an iterator to it.

Synopsis

Declared in <bslstl_list.h>

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

Description

This method offers full guarantee of rollback in case an exception is thrown other than by the VALUE copy constructor or assignment operator. 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()]endpoints included).

Return Value

iterator to the newly inserted element

Parameters

Name

Description

dstPosition

location before which the element is inserted

value

element to copy‐insert

Created with MrDocs