| (1) | |||
| (1) | (since C++11) | ||
| (2) | |||
| (2) | (since C++11) | ||
| (3) | |||
| (3) | (since C++11) |
Transfers elements from one list to another.
No elements are copied or moved, only the internal pointers of the list nodes are re-pointed. The behavior is undefined if: get_allocator() != other.get_allocator(). No iterators or references become invalidated, the iterators to moved elements remain valid, but now refer into *this, not into other.
1) Transfers 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) Transfers the element pointed to by
it from other into *this. The element is inserted before the element pointed to by pos. 3) Transfers 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).Parameters
| pos | - | element before which the content will be inserted |
| other | - | another container to transfer the content from |
| it | - | the element to transfer from other to *this |
| first, last | - | the range of elements to transfer from other to *this |
Return value
(none).
Complexity
1-2) Constant.
3) Constant if this == &other, otherwise linear in std::distance(first, last).
Example
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 | #include <iostream>#include <list> std::ostream& operator<<(std::ostream& ostr, const std::list<int>& list){ for (auto &i : list) { ostr << " " << i; } return ostr;} int main (){ std::list<int> list1 = { 1, 2, 3, 4, 5 }; std::list<int> list2 = { 10, 20, 30, 40, 50 }; auto it = list1.begin(); std::advance(it, 2); list1.splice(it, list2); std::cout << "list1: " << list1 << "\n"; std::cout << "list2: " << list2 << "\n"; list2.splice(list2.begin(), list1, it, list1.end()); std::cout << "list1: " << list1 << "\n"; std::cout << "list2: " << list2 << "\n";} |
Output:
1 2 3 4 | list1: 1 2 10 20 30 40 50 3 4 5list2: list1: 1 2 10 20 30 40 50list2: 3 4 5 |
See also
| merges two sorted lists (public member function) | |
| removes elements satisfying specific criteria (public member function) |
Please login to continue.