bsl::list::splice

Splice the single element at srcNode from src into this list.

Synopsis

Declared in <bslstl_list.h>

void
splice(
    const_iterator dstPosition,
    list& src,
    const_iterator srcNode);

Description

The element is inserted at dstPosition. The behavior is undefined unless srcNode refers to a valid element in src, 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 the element is moved to a (possibly) new position in the list.

Parameters

NameDescription
dstPositionlocation before which the element is inserted
srclist containing the element to move
srcNodeiterator to the element to move