Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Restitches links between nodes.
void splice_after(const_iterator _Where, forward_list& _Right);
void splice_after(const_iterator _Where, forward_list& _Right,
iterator _First);
void splice_after(const_iterator _Where, forward_list& _Right,
iterator _First, iterator _Last);
Parameters
Parameter |
Description |
|---|---|
_Where |
The position in the target forward list to splice. |
_First |
The beginning of the restitched range. |
_Last |
The end of the restitched range. |
_Right |
The forward list to splice from. |
Remarks
The first member function inserts the sequence controlled by _Right just after the element in the controlled sequence pointed to by _Where. It also removes all elements from _Right. (&_Right must not equal this.)
The second member function removes the element just after _First in the sequence controlled by _Right and inserts it just after the element in the controlled sequence pointed to by _Where. (If _Where == _First || _Where == ++_First, no change occurs.)
The third member function inserts the subrange designated by (_First, _Last) from the sequence controlled by _Right just after the element in the controlled sequence pointed to by _Where. It also removes the original subrange from the sequence controlled by _Right. (If &_Right == this, the range (_First, _Last) must not include the element pointed to by _Where.)
If the third member function inserts N elements, and &_Right != this, an object of class iterator is incremented N times. For all splice_after member functions, if get_allocator() == str.get_allocator(), no exception occurs. Otherwise, a copy and a destructor call also occur for each inserted element.
No iterators or references that designate spliced elements become invalid.
Requirements
Header: <forward_list>
Namespace: std