Namespaces
Variants
Views
Actions

Difference between revisions of "Template:cpp/container/back"

From cppreference.com
(Use equivalent expression without temporary.)
m (Notes: a return statement is not an expression)
Line 42: Line 42:
  
 
===Notes===
 
===Notes===
For a non-empty container {{tt|c}}, the expression {{c|return c.back();}} is equivalent to {{c|return *std::prev(c.end());}}
+
For a non-empty container {{tt|c}}, the expression {{c|c.back()}} is equivalent to {{c|*std::prev(c.end())}}
  
 
===Example===
 
===Example===

Revision as of 08:44, 18 April 2020

reference back();
(since {std})
const_reference back() const;
(since {std})

Returns reference to the last element in the container.

Calling back on an empty container causes undefined behavior.

Contents

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

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 {'a', 'b', 'c', 'd', 'e', '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 of std::{{{1}}}) [edit]