list end() function in C++ STL

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.

filter_none

edit
close

play_arrow

link
brightness_4
code

// 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;
}

chevron_right


Output:

Returned iterator points to : 4
10 20 30 40

Note: This function works in constant time complexity.



My Personal Notes arrow_drop_up

Check out this Author's contributed articles.

If you like GeeksforGeeks and would like to contribute, you can also write an article using contribute.geeksforgeeks.org or mail your article to contribute@geeksforgeeks.org. See your article appearing on the GeeksforGeeks main page and help other Geeks.

Please Improve this article if you find anything incorrect by clicking on the "Improve Article" button below.




Article Tags :
Practice Tags :


Be the First to upvote.


Please write to us at contribute@geeksforgeeks.org to report any issue with the above content.