Insert numElements copies of value at dstPosition.
Declared in <bslstl_list.h>
list<VALUE, ALLOCATOR>::iterator
insert(
const_iterator dstPosition,
size_type numElements,
value_type const& value);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).
iterator to the first inserted element, or dstPosition if empty
| Name | Description |
|---|---|
| dstPosition | location before which elements are inserted |
| numElements | number of copies of value to insert |
| value | value copied into each inserted element |