Insert a copy of value at dstPosition and return an iterator to it.
Declared in <bslstl_list.h>
list<VALUE, ALLOCATOR>::iterator
insert(
const_iterator dstPosition,
value_type const& value);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).
iterator to the newly inserted element
| Name | Description |
|---|---|
| dstPosition | location before which the element is inserted |
| value | element to copy-insert |