(C++17) | ||||
Sequence | ||||
(C++11) | ||||
(C++26) | ||||
(C++26) | ||||
(C++11) | ||||
Associative | ||||
Unordered associative | ||||
(C++11) | ||||
(C++11) | ||||
(C++11) | ||||
(C++11) | ||||
Adaptors | ||||
(C++23) | ||||
(C++23) | ||||
(C++23) | ||||
(C++23) | ||||
Views | ||||
(C++20) | ||||
(C++23) | ||||
Tables | ||||
Iterator invalidation | ||||
Member function table | ||||
Non-member function table |
Member functions | |||||||
Non-member functions | |||||||
| |||||||
Deduction guides(C++17) |
reverse_iterator rbegin(); | (1) | (noexcept since C++11) (constexpr since C++26) |
const_reverse_iterator rbegin()const; | (2) | (noexcept since C++11) (constexpr since C++26) |
const_reverse_iterator crbegin()constnoexcept; | (3) | (since C++11) (constexpr since C++26) |
Returns a reverse iterator to the first element of the reversed*this. It corresponds to the last element of the non-reversed*this.
If*this is empty, the returned iterator is equal torend().
Contents |
Reverse iterator to the first element.
Constant.
Theunderlying iterator of the returned reverse iterator is theend iterator. Hence the returned iterator is invalidated if and when the end iterator is invalidated.
libc++ backportscrbegin()
to C++98 mode.
#include <algorithm>#include <iostream>#include <string>#include <map> int main(){std::multimap<std::string,int> map{{"█",1},{"▒",5},{"░",3},{"▓",7},{"▓",8},{"░",4},{"▒",6},{"█",2}}; std::cout<<"Print out in reverse order using const reverse iterators:\n";std::for_each(map.crbegin(), map.crend(),[](std::pair<conststd::string,int>const& e){std::cout<<"{\""<< e.first<<"\", "<< e.second<<" };\n";}); map.rbegin()->second=42;// OK, non-const value is modifiable// map.crbegin()->second = 42; // Error: cannot modify the const value}
Possible output:
Print out in reverse order using const reverse iterators:{ "▓", 8 };{ "▓", 7 };{ "▒", 6 };{ "▒", 5 };{ "░", 4 };{ "░", 3 };{ "█", 2 };{ "█", 1 };
(C++11) | returns a reverse iterator to the end (public member function)[edit] |
(C++14) | returns a reverse iterator to the beginning of a container or array (function template)[edit] |