std::rbegin, std::crbegin
Определено в заголовочном файле <array> | ||
|---|---|---|
Определено в заголовочном файле <deque> | ||
Определено в заголовочном файле <flat_map> | (начиная с C++23) | |
Определено в заголовочном файле <flat_set> | (начиная с C++23) | |
Определено в заголовочном файле <forward_list> | ||
Определено в заголовочном файле <hive> | (начиная с C++26) | |
Определено в заголовочном файле <inplace_vector> | (начиная с C++26) | |
Определено в заголовочном файле <iterator> | ||
Определено в заголовочном файле <list> | ||
Определено в заголовочном файле <map> | ||
Определено в заголовочном файле <optional> | (начиная с C++26) | |
Определено в заголовочном файле <regex> | ||
Определено в заголовочном файле <set> | ||
Определено в заголовочном файле <span> | (начиная с C++20) | |
Определено в заголовочном файле <stacktrace> | (начиная с C++23) | |
Определено в заголовочном файле <string> | ||
Определено в заголовочном файле <string_view> | (начиная с C++17) | |
Определено в заголовочном файле <unordered_map> | ||
Определено в заголовочном файле <unordered_set> | ||
Определено в заголовочном файле <valarray> | ||
Определено в заголовочном файле <vector> |
template< class C >
auto rbegin( C& c ) noexcept(noexcept(c.rbegin()))
-> decltype(c.rbegin());
| (1) |
(начиная с C++14) (constexpr начиная с C++17) |
template< class C >
auto rbegin( const C& c ) noexcept(noexcept(c.rbegin()))
-> decltype(c.rbegin());
| (2) |
(начиная с C++14) (constexpr начиная с C++17) |
template< class T, std::size_t N > std::reverse_iterator<T*> rbegin( T (&array)[N] ) noexcept; | (3) |
(начиная с C++14) (constexpr начиная с C++17) |
template< class T > std::reverse_iterator<const T*> rbegin( std::initializer_list<T> il ) noexcept; | (4) |
(начиная с C++14) (constexpr начиная с C++17) |
template< class C >
auto crbegin( const C& c ) noexcept(noexcept(std::rbegin(c)))
-> decltype(std::rbegin(c));
| (5) |
(начиная с C++14) (constexpr начиная с C++17) |
Возвращает итератор, указывающий на обратное начало заданного диапазона.
c.rbegin(), который обычно является итератором, указывающим на обратное начало последовательности, представленной c.array.il.std::rbegin(c), при этом c всегда рассматривается как имеющий квалификатор const.Параметры
| c | - | контейнер или представление с функцией-членом rbegin |
| array | - | массив произвольного типа |
| il | - | std::initializer_list |
Возвращаемое значение
c.rbegin()
std::reverse_iterator<T*>(array + N)
std::reverse_iterator<const T*>(il.end())
std::rbegin(c)
Исключения
c.rbegin(), и условия его выбрасывания.std::rbegin(c), и условия его выбрасывания.Перегрузки
Для классов и перечислений, которые не предоставляют подходящую функцию-член rbegin(), но допускают итерацию, можно определить пользовательские перегрузки rbegin.
| Перегрузки | (начиная с C++20) |
Примечания
Перегрузка для std::initializer_list необходима, поскольку у него нет функции-члена rbegin.
Пример
#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 3
Отчёты об ошибках
Следующие отчёты об ошибках, изменяющие поведение, были применены задним числом к ранее опубликованным стандартам C++.
| DR | Применяется к | Поведение согласно опубликованному стандарту | Корректное поведение |
|---|---|---|---|
| LWG 3537 | C++14 |
От std::rbegin и std::crbegin не требовалось передавать спецификацию исключений | требуется |
См. также
|
(C++11)(C++14) | возвращает итератор, указывающий на начало контейнера или массива (шаблон функции) |
|
(C++11)(C++14) | возвращает итератор, указывающий на конец контейнера или массива (шаблон функции) |
|
(C++14) | возвращает обратный итератор конца контейнера или массива (шаблон функции) |
|
(C++20) | возвращает обратный итератор для диапазона (объект-точка настройки) |
|
(C++20) | возвращает обратный итератор для диапазона только для чтения (объект-точка настройки) |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/iterator/rbegin