std::list<T,Allocator>::back (3) - Linux Manuals

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

Command to display std::list<T,Allocator>::back manual in Linux: $ man 3 std::list<T,Allocator>::back

NAME

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

Synopsis

reference back();
const_reference back() const;

Returns reference to the last element in the container.
Calling back on an empty container is undefined.

Parameters

(none)

Return value

Reference to the last element.

Complexity

Constant.

Notes

For a container c, the expression return c.back(); is equivalent to { auto tmp = c.end(); --tmp; return *tmp; }

Example

The following code uses back to display the last element of a std::list<char>:
// Run this code

#include <list>
#include <iostream>

  int main()
  {
      std::list<char> letters {'a', 'b', 'c', 'd', 'e', 'f'};
      if (!letters.empty()) {
          std::cout << "The last character is: " << letters.back() << '\n';
      }
  }

Output:

The last character is f