std::rend, std::crend
Определено в заголовочном файле <array> |
||
|---|---|---|
Определено в заголовочном файле <deque> |
||
Определено в заголовочном файле <forward_list> |
||
Определено в заголовочном файле <iterator> |
||
Определено в заголовочном файле <list> |
||
Определено в заголовочном файле <map> |
||
Определено в заголовочном файле <regex> |
||
Определено в заголовочном файле <set> |
||
Определено в заголовочном файле <span> |
(с C++20) | |
Определено в заголовочном файле <string> |
||
Определено в заголовочном файле <string_view> |
(с C++17) | |
Определено в заголовочном файле <unordered_map> |
||
Определено в заголовочном файле <unordered_set> |
||
Определено в заголовочном файле <vector> |
||
| (1) | ||
template< class C > auto rend( C& c ) -> decltype(c.rend()); |
(с C++14) (до C++17) |
|
template< class C > constexpr auto rend( C& c ) -> decltype(c.rend()); |
(с C++17) | |
| (1) | ||
template< class C > auto rend( const C& c ) -> decltype(c.rend()); |
(с C++14) (до C++17) |
|
template< class C > constexpr auto rend( const C& c ) -> decltype(c.rend()); |
(с C++17) | |
| (2) | ||
template< class T, std::size_t N > std::reverse_iterator<T*> rend( T (&array)[N] ); |
(с C++14) (до C++17) |
|
template< class T, std::size_t N > constexpr std::reverse_iterator<T*> rend( T (&array)[N] ); |
(с C++17) | |
| (3) | ||
template< class T > std::reverse_iterator<const T*> rend( std::initializer_list<T> il ); |
(с C++14) (до C++17) |
|
template< class T > constexpr std::reverse_iterator<const T*> rend( std::initializer_list<T> il ); |
(с C++17) | |
| (4) | ||
template< class C > auto crend( const C& c ) -> decltype(std::rend(c)); |
(с C++14) (до C++17) |
|
template< class C > constexpr auto crend( const C& c ) -> decltype(std::rend(c)); |
(с C++17) |
Возвращает итератор к обратному концу заданного диапазона.
1) Возвращает итератор к обратному концу, возможно, константного контейнера или представления
c.
4) Возвращает итератор к обратному концу константного контейнера или представления
c.
Параметры
| c | - | контейнер или представление с членом-функцией rend |
| array | - | массив произвольного типа |
| il | - | initializer_list |
Возвращаемое значение
1)
c.rend()
2)
std::reverse_iterator<T*>(array)
3)
std::reverse_iterator<const T*>(il.begin())
4)
c.rend()
Исключения
Может выбросить исключения, определённые реализацией.
Перегрузки
Могут быть предоставлены пользовательские перегрузки rend для классов и перечислений, которые не предоставляют подходящей функции-члена rend(), но могут быть итерированы.
|
Перегрузки |
(с C++20) |
Примечания
Перегрузка для std::initializer_list необходима, поскольку она не имеет функции-члена rend.
Пример
#include <algorithm>
#include <iostream>
#include <iterator>
#include <vector>
int main()
{
int a[]{4, 6, -3, 9, 10};
std::cout << "C-style array `a` backwards: ";
std::copy(std::rbegin(a), std::rend(a), std::ostream_iterator<int>(std::cout, " "));
auto il = {3, 1, 4};
std::cout << "\nstd::initializer_list `il` backwards: ";
std::copy(std::rbegin(il), std::rend(il), std::ostream_iterator<int>(std::cout, " "));
std::vector<int> v{4, 6, -3, 9, 10};
std::cout << "\nstd::vector `v` backwards: ";
std::copy(std::rbegin(v), std::rend(v), std::ostream_iterator<int>(std::cout, " "));
std::cout << '\n';
}Вывод:
C-style array `a` backwards: 10 9 -3 6 4 std::initializer_list `il` backwards: 4 1 3 std::vector `v` backwards: 10 9 -3 6 4
См. также
|
(C++11)(C++14)
|
возвращает итератор к концу контейнера или массива (шаблон функции) |
|
(C++14)
|
возвращает обратный итератор к началу контейнера или массива (шаблон функции) |
|
(C++11)(C++14)
|
возвращает итератор к началу контейнера или массива (шаблон функции) |
|
(C++20)
|
возвращает обратный итератор к концу диапазона (объект точки настройки) |
|
(C++20)
|
возвращает обратный итератор к концу только для чтения диапазона (объект точки настройки) |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/iterator/rend
