C++ List Library - splice() Function

---

Description

The C++ function std::list::splice() transfers the elements in the range of first to last from x to *this. The elements are inserted before the element pointed to by position.

Declaration

Following is the declaration for std::list::splice() function form std::list header.

C++98

void splice (iterator position, list& x, iterator first, iterator last);

C++11

void splice (const_iterator position, list& x, const_iterator first, const_iterator last);

Parameters

• position − Position in the list where new element to be inserted.

• x − Another list object of same type.

• first − Input iterator to the initial position in range

• last − Input iterator to the final position in range

Return value

None

Exceptions

The behavior is undefined if provided range is not valid.

Time complexity

Linear i.e. O(n)

Example

The following example shows the usage of std::list::splice() function.

#include <iostream>
#include <list>

using namespace std;

int main(void) {
   list<int> l1 = {1, 2};
   list<int> l2 = {3, 4, 5};

   l1.splice(l1.end(), l2, l2.begin(), l2.end());

   cout << "Contents of list l1 after splice operation" << endl;

   for (auto it = l1.begin(); it != l1.end(); ++it)
      cout << *it << endl;

   return 0;
}

Let us compile and run the above program, this will produce the following result −

Contents of list l1 after splice operation
1
2
3
4
5