Skip to content

Search topics & cppreference

Search all study topics, concept maps, and 6,587 C++ and C reference pages.

std::list<T,Allocator>::back

Returns a reference to the last element in the container.

Containers
  • C++98
  • C++11
1 min readView on cppreference
NotebookLM
reference back();
(1)
const_reference back() const;
(2)

Returns a reference to the last element in the container.

Calling back on an empty container causes undefined behavior.

Parameters

(none)

Return value

Reference to the last element.

Complexity

Constant.

Notes

For a non-empty container c, the expression c.back() is equivalent to *std::prev(c.end()).

Example

example.cpp
#include <cassert>
#include <list>
 
int main()
{
    std::list<char> letters{'a', 'b', 'c', 'd'};
    assert(letters.back() == 'd');
}

See also

access the first element
(public member function)
returns a reverse iterator to the beginning
(public member function)
(C++11)
returns an iterator to the end
(public member function)

Content from this page on cppreference.com, licensed under CC-BY-SA 3.0 and GFDL. Modified: restyled, site navigation removed, code windows added. Offline snapshot of 9 February 2025.