C++ Forward_list Library - assign() Function

---

---

Description

The C++ function std::forward_list::assign() assigns new value to forward_list by replacing old ones. New elements are constructed in range of first to last.

Declaration

Following is the declaration for std::forward_list::assign() function form std::forward_list header.

C++11

template <class InputIterator>
void assign (InputIterator first, InputIterator last);

Parameters

• first − Input iterator to the initial position in range.

• last − Input iterator to the final position in range.

Return value

None.

Exceptions

If range specified by first and last is not valid then result is undefined.

Time complexity

Linear i.e. O(n)

Example

The following example shows the usage of std::forward_list::assign() function.

#include <iostream>
#include <forward_list>

using namespace std;

int main(void) {

   forward_list<int> fl1 = {1, 2, 3, 4, 5};
   forward_list<int> fl2;

   fl2.assign(fl1.begin(), fl1.end());

   cout << "List contains following elements" << endl;

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

   return 0;
}

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

List contains following elements
1
2
3
4
5