W3cubDocs

/C++

std::array::back

reference back();
(until C++17)
constexpr reference back();
(since C++17)
const_reference back() const;
(until C++14)
constexpr const_reference back() const;
(since C++14)

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::array<char>:

#include <array>
#include <iostream>
 
int main()
{
    std::array<char, 6> letters {'o', 'm', 'g', 'w', 't', 'f'};
    if (!letters.empty()) {
        std::cout << "The last character is: " << letters.back() << '\n';
    }  
}

Output:

The last character is f

See also

access the first element
(public member function)

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