Splice the range [first .. last)] from src into this list.
Declared in <bslstl_list.h>
void
splice(
const_iterator dstPosition,
list& src,
const_iterator first,
const_iterator last);
The elements are inserted, in the same order, at dstPosition. The behavior is undefined unless [first .. last)] represents a range of valid elements in src, dstPosition is not in the range [first .. last)], this list and src use the same allocator, and dstPosition is in the range [begin() .. end()] (note both endpoints included). Note that src and *this may be the same list, in which case an entire sequence of nodes is moved to a (possibly) new position in this list.
| Name | Description |
|---|---|
| dstPosition | location before which elements are inserted |
| src | list containing the range to move |
| first | start of the range to move |
| last | one past the end of the range to move |