| Defined in header <array>
|
||
| Defined in header <deque>
|
||
| Defined in header <flat_map>
|
||
| Defined in header <flat_set>
|
||
| Defined in header <forward_list>
|
||
| Defined in header <inplace_vector>
|
||
| Defined in header <iterator>
|
||
| Defined in header <list>
|
||
| Defined in header <map>
|
||
| Defined in header <regex>
|
||
| Defined in header <set>
|
||
| Defined in header <span>
|
||
| Defined in header <string>
|
||
| Defined in header <string_view>
|
||
| Defined in header <unordered_map>
|
||
| Defined in header <unordered_set>
|
||
| Defined in header <vector>
|
||
template< class C > auto rbegin( C& c ) -> decltype(c.rbegin()); |
(1) | (since C++14) (constexpr since C++17) |
template< class C > auto rbegin( const C& c ) -> decltype(c.rbegin()); |
(2) | (since C++14) (constexpr since C++17) |
template< class T, std::size_t N > std::reverse_iterator<T*> rbegin( T (&array)[N] ); |
(3) | (since C++14) (constexpr since C++17) |
template< class T > std::reverse_iterator<const T*> rbegin( std::initializer_list<T> il ); |
(4) | (since C++14) (constexpr since C++17) |
template< class C > auto crbegin( const C& c ) -> decltype(std::rbegin(c)); |
(5) | (since C++14) (constexpr since C++17) |
Returns an iterator to the reverse-beginning of the given range.
c.rbegin(), which is typically an iterator to the reverse-beginning of the sequence represented by c.std::rbegin(c), with c always treated as const-qualified.
Parameters
| c | - | a container or view with a rbegin member function
|
| array | - | an array of arbitrary type |
| il | - | an std::initializer_list |
Return value
c.rbegin()std::reverse_iterator<T*>(array + N)std::reverse_iterator<const T*>(il.end())c.rbegin()Exceptions
May throw implementation-defined exceptions.
Overloads
Custom overloads of rbegin may be provided for classes and enumerations that do not expose a suitable rbegin() member function, yet can be iterated.
|
Overloads of |
(since C++20) |
Notes
The overload for std::initializer_list is necessary because it does not have a member function rbegin.
Example
#include <iostream>
#include <iterator>
#include <vector>
int main()
{
std::vector<int> v = {3, 1, 4};
auto vi = std::rbegin(v); // the type of “vi” is std::vector<int>::reverse_iterator
std::cout << "*vi = " << *vi << '\n';
*std::rbegin(v) = 42; // OK: after assignment v[2] == 42
// *std::crbegin(v) = 13; // error: the location is read-only
int a[] = {-5, 10, 15};
auto ai = std::rbegin(a); // the type of “ai” is std::reverse_iterator<int*>
std::cout << "*ai = " << *ai << '\n';
auto il = {3, 1, 4};
// the type of “it” below is std::reverse_iterator<int const*>:
for (auto it = std::rbegin(il); it != std::rend(il); ++it)
std::cout << *it << ' ';
std::cout << '\n';
}*vi = 4
*ai = 15
4 1 3See also
| (C++11)(C++14) |
returns an iterator to the beginning of a container or array (function template) |
| (C++11)(C++14) |
returns an iterator to the end of a container or array (function template) |
| (C++14) |
returns a reverse end iterator for a container or array (function template) |
| (C++20) |
returns a reverse iterator to a range (customization point object) |
| (C++20) |
returns a reverse iterator to a read-only range (customization point object) |
Content from this page on cppreference.com, licensed under CC-BY-SA 3.0 and GFDL. Modified: restyled, site navigation removed, code windows added. Offline snapshot of 9 February 2025.