Namespaces
Variants
Views
Actions

std::{{{1}}}::back

From cppreference.com
Revision as of 10:03, 21 May 2013 by Dieram3 (Talk | contribs)

Template:ddcl list begin <tr class="t-dcl ">

<td class="t-dcl-nopad">
reference back();
</td>

<td class="t-dcl-nopad"> </td> <td class="t-dcl-nopad"> </td> </tr> <tr class="t-dcl ">

<td class="t-dcl-nopad">
constexpr const_reference back() const;
</td>

<td class="t-dcl-nopad"> </td> <td class="t-dcl-nopad"> </td> </tr> Template:ddcl list end

Returns reference to the last element in the container.

Calling back on an empty container is undefined.

Contents

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

Const version is marked as constexpr since c++14

Example

The following code uses back to display the last element of a std::{{{1}}}<char>:

#include <{{{1}}}>
#include <iostream>
 
int main()
{
    std::{{{1}}}<char> 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

Template:cpp/container/dcl list front