list end() function in C++ STL

Last Updated : 20 Jun, 2018

The list::end() is a built-in function in C++ STL which is used to get an iterator to past the last element. By past the last element it is meant that the iterator returned by the end() function return an iterator to an element which follows the last element in the list container. It can not be used to modify the element or the list container.

This function is basically used to set a range along with the list::begin() function.

Syntax:

list_name.end()

Parameters: This function does not accept any parameter, it simply returns an iterator to past the last element.

Return Value: This function returns an iterator to the element past the last element of the list.

Below program illustrates the list::end() function.

// CPP program to illustrate the 
// list::end() function 
#include <bits/stdc++.h> 
using namespace std; 
  
int main() 
{ 
    // Creating a list 
    list<int> demoList; 
  
    // Add elements to the List 
    demoList.push_back(10); 
    demoList.push_back(20); 
    demoList.push_back(30); 
    demoList.push_back(40); 
  
    // using end() to get iterator  
    // to past the last element 
    list<int>::iterator it = demoList.end(); 
  
    // This will not print the last element 
    cout << "Returned iterator points to : " << *it << endl; 
  
    // Using end() with begin() as a range to 
    // print all of the list elements 
    for (auto itr = demoList.begin(); 
         itr != demoList.end(); itr++) { 
        cout << *itr << " "; 
    } 
  
    return 0; 
} 

Output:

Returned iterator points to : 4
10 20 30 40

Note: This function works in constant time complexity.

Suggest improvement

list push_back() function in C++ STL

list remove() function in C++ STL

Share your thoughts in the comments

list end() function in C++ STL

Please Login to comment...

Similar Reads

What kind of Experience do you want to share?