Namespaces
Variants
Views
Actions

std::ranges::view_interface<D>::back

From cppreference.com
 
 
 
std::ranges::view_interface
Member functions
(C++20)
(C++20)
(C++20)
(C++20)
back
(C++20)
(C++20)
 
constexpr decltype(auto) back()
    requires ranges::bidirectional_range<D> && ranges::common_range<D>;
(1) (since C++20)
constexpr decltype(auto) back() const
    requires ranges::bidirectional_range<const D> && ranges::common_range<const D>;
(2) (since C++20)

The default implementation of back() member function returns the last element in the view of the derived type. Whether the element is returned by value or by reference depends on the operator* of the iterator type.

1) Let derived be static_cast<D&>(*this). Equivalent to return *ranges::prev(ranges::end(derived));. The behavior is undefined if empty() is true (i.e. the beginning iterator compares equal to the sentinel), even if the iterator obtained in the same way is dereferenceable.
2) Same as (1), except that derived is static_cast<const D&>(*this).

Contents

[edit] Parameters

(none)

[edit] Return value

The last element in the view.

[edit] Notes

In C++20, no type derived from std::ranges::view_interface in the standard library provides their own back() member function.

However, following derived types cannot use the default implementations, as they never satisfy both bidirectional_range and common_range:

The inherited back() member function is available for std::ranges::empty_view, but a call to it always results in undefined behavior.

[edit] Example

[edit] See also

returns a reverse iterator to a container or array
(function template) [edit]
returns a reverse iterator to a range
(customization point object) [edit]
returns a reverse iterator to a read-only range
(customization point object) [edit]