Splice the range [first .. last)] from src into this list.

Synopsis

Declared in <bslstl_list.h>

void
splice(
    const_iterator dstPosition,
    list& src,
    const_iterator first,
    const_iterator last);

Description

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.

Parameters

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

Created with MrDocs