Spec-Zone.ru › C++

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

reference back();
(1)
const_reference back() const;
(2)

Returns a reference to the last element in the container.

If empty() is true, the behavior is undefined.

(until C++26)

If empty() is true:

  • If the implementation is hardened, a contract violation occurs.
  • If the implementation is not hardened, the behavior is undefined.
(since C++26)

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

#include <cassert>
#include <list>

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

See also

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

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/container/list/back

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API