std::flat_map<Key,T,Compare,KeyContainer,MappedContainer>::rbegin, std::flat_map<Key,T,Compare,KeyContainer,MappedContainer>::crbegin - cppreference.com (original) (raw)

reverse_iterator rbegin() noexcept; (1) (since C++23) (constexpr since C++26)
const_reverse_iterator rbegin() const noexcept; (2) (since C++23) (constexpr since C++26)
const_reverse_iterator crbegin() const noexcept; (3) (since C++23) (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 to rend().

range-rbegin-rend.svg

[edit] Return value

Reverse iterator to the first element.

[edit] Complexity

Constant.

[edit] Notes

The underlying iterator of the returned reverse iterator is the end iterator. Hence the returned iterator is invalidated if and when the end iterator is invalidated.

[edit] Example

#include #include #include #include   int main() { const std::flat_map<int, std::string_view> coins { {10, "dime"}, {100, "dollar"}, {50, "half dollar"}, {5, "nickel"}, {1, "penny"}, {25, "quarter"} }; // initializer entries in name alphabetical order   std::cout << "US coins in circulation, largest to smallest denomination:\n"; for (auto it = coins.crbegin(); it != coins.crend(); ++it) std::cout << std::setw(11) << it->second << " = ¢" << it->first << '\n'; }

Output:

US coins in circulation, largest to smallest denomination: dollar = ¢100 half dollar = ¢50 quarter = ¢25 dime = ¢10 nickel = ¢5 penny = ¢1

[edit] See also

| | returns a reverse iterator to the end (public member function) [edit] | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | returns a reverse iterator to the beginning of a container or array (function template) [edit] |