std::forward_list::splice

From Cppreference

C++ Standard Library
Language Utilities library Strings library Containers library Algorithms library Iterators library Numerics library Input/output library Localizations library Regular expressions library (C++11) Atomic operations library (C++11) Thread support library (C++11)
Containers library
array (C++11) vector deque forward_list (C++11) list set multiset map multimap unordered_set (C++11) unordered_multiset (C++11) unordered_map (C++11) unordered_multimap (C++11) stack queue priority_queue
std::forward_list
Member functions forward_list::forward_list forward_list::~forward_list forward_list::operator= forward_list::assign forward_list::get_allocator Element access forward_list::front Iterators forward_list::before_begin forward_list::cbefore_begin forward_list::begin forward_list::cbegin forward_list::end forward_list::cend Capacity forward_list::empty forward_list::max_size Modifiers forward_list::clear forward_list::insert_after forward_list::emplace_after forward_list::erase_after forward_list::push_front forward_list::emplace_front forward_list::pop_front forward_list::resize forward_list::swap Operations forward_list::merge forward_list::splice_after forward_list::remove forward_list::remove_if forward_list::reverse forward_list::unique forward_list::sort

void splice(const_iterator pos, forward_list& other);	(1)	(C++11 feature)
void splice(const_iterator pos, forward_list&& other);	(1)	(C++11 feature)
void splice(const_iterator pos, forward_list& other, const_iterator it);	(2)	(C++11 feature)
void splice(const_iterator pos, forward_list&& other, const_iterator it);	(2)	(C++11 feature)
void splice(const_iterator pos, forward_list& other,             const_iterator first, const_iterator last);	(3)	(C++11 feature)
void splice(const_iterator pos, forward_list&& other,             const_iterator first, const_iterator last);	(3)	(C++11 feature)

Moves elements from one list to another.

No elements are copied. The behavior is undefined if: get_allocator() != other.get_allocator(). No iterators or references become invalidated, the iterators to moved elements now refer into *this, not into other.

1) Moves all elements from other into *this. The elements are inserted before the element pointed to by pos. The container other becomes empty after the operation. The behavior is undefined if this == &other.

2) Moves the element pointed to by it from other into *this. The element is inserted before the element pointed to by pos.

3) Moves the elements in the range [first, last) from other into *this. The elements are inserted before the element pointed to by pos. The behavior is undefined if pos is an iterator in the range [first,last).

Contents 1 Parameters 2 Return value 3 Example 4 Complexity 5 See also

[edit] Parameters

pos	-	element before which the content will be inserted
other	-	another container to move the content from
it	-	the element to move from other to *this
first, last	-	the range of elements to move from other to *this

[edit] Return value

(none)

[edit] Example

This section is incomplete

[edit] Complexity

1-2) Constant

3) Constant if this != &other, otherwise linear.

[edit] See also

merge	merges two sorted lists (public member function)
remove remove_if	removes elements satisfying specific criteria (public member function)