C++ <forward_list> - end() Function

The C++ forward_list::end function returns the iterator pointing to the past-the-last element of the forward_list container. The past-the-last element of the forward_list is the theoretical element that follows the last element. It does not point to any element, and hence could not be dereferenced.

Syntax

• C++11

iterator end() noexcept;
const_iterator end() const noexcept;

Parameters

No parameter is required.

Return Value

An iterator to the past-the-last element of the sequence container. If the sequence object is constant qualified, the function returns a const_iterator, else returns an iterator.

Time Complexity

Constant i.e, Θ(1).

Example:

In the example below, the forward_list::end function returns the iterator pointing to the past-the-last element of the forward_list flist. The forward_list::end function is often used with forward_list::begin function to specify a range including all elements of the forward_list container.

#include <iostream>
#include <forward_list>
using namespace std;
 
int main (){
  forward_list<int> flist{10, 20, 30, 40, 50};
  forward_list<int>::iterator it;

  for(it = flist.begin(); it != flist.end(); ++it)
    cout<<*it<<" ";

  return 0;
}

The output of the above code will be:

10 20 30 40 50