std::rend, std::crend
De cppreference.com
<tbody>
</tbody>
<tbody class="t-dcl-rev t-dcl-rev-num ">
</tbody><tbody>
</tbody>
<tbody class="t-dcl-rev t-dcl-rev-num ">
</tbody><tbody>
</tbody>
<tbody class="t-dcl-rev t-dcl-rev-num ">
</tbody><tbody>
</tbody>
<tbody class="t-dcl-rev t-dcl-rev-num ">
</tbody><tbody>
</tbody>
<tbody class="t-dcl-rev t-dcl-rev-num ">
</tbody><tbody>
</tbody>
| Definido en el archivo de encabezado <array>
|
||
| Definido en el archivo de encabezado <deque>
|
||
| Definido en el archivo de encabezado <flat_map>
|
||
| Definido en el archivo de encabezado <flat_set>
|
||
| Definido en el archivo de encabezado <forward_list>
|
||
| Definido en el archivo de encabezado <inplace_vector>
|
||
| Definido en el archivo de encabezado <iterator>
|
||
| Definido en el archivo de encabezado <list>
|
||
| Definido en el archivo de encabezado <map>
|
||
| Definido en el archivo de encabezado <regex>
|
||
| Definido en el archivo de encabezado <set>
|
||
| Definido en el archivo de encabezado <span>
|
||
| Definido en el archivo de encabezado <string>
|
||
| Definido en el archivo de encabezado <string_view>
|
||
| Definido en el archivo de encabezado <unordered_map>
|
||
| Definido en el archivo de encabezado <unordered_set>
|
||
| Definido en el archivo de encabezado <vector>
|
||
| (1) | ||
template< class C > auto rend( C& c ) -> decltype(c.rend()); |
(desde C++14) (hasta C++17) |
|
template< class C > constexpr auto rend( C& c ) -> decltype(c.rend()); |
(desde C++17) | |
| (2) | ||
template< class C > auto rend( const C& c ) -> decltype(c.rend()); |
(desde C++14) (hasta C++17) |
|
template< class C > constexpr auto rend( const C& c ) -> decltype(c.rend()); |
(desde C++17) | |
| (3) | ||
template< class T, std::size_t N > std::reverse_iterator<T*> rend( T (&array)[N] ); |
(desde C++14) (hasta C++17) |
|
template< class T, std::size_t N > constexpr std::reverse_iterator<T*> rend( T (&array)[N] ); |
(desde C++17) | |
| (4) | ||
template< class T > std::reverse_iterator<const T*> rend( std::initializer_list<T> il ); |
(desde C++14) (hasta C++17) |
|
template< class T > constexpr std::reverse_iterator<const T*> rend( std::initializer_list<T> il ); |
(desde C++17) | |
| (5) | ||
template< class C > auto crend( const C& c ) -> decltype(std::rend(c)); |
(desde C++14) (hasta C++17) |
|
template< class C > constexpr auto crend( const C& c ) -> decltype(std::rend(c)); |
(desde C++17) | |
Devuelve un iterador al final inverso del rango c dado.
1,2) Devuelve
c.rend(), que es típicamente un iterador un paso después del final inverso de la secuencia representada por c.3) Devuelve un objeto
std::reverse_iterator<T*> al final inverso de array.4) Devuelve un objeto
std::reverse_iterator<const T*> al final inverso de il.5) Devuelve
std::end(c), que c siempre trataba como calificado const.Parámetros
| c | - | Un contenedor con una función miembro rend.
|
| array | - | Un array de tipo arbitrario. |
| il | - | Una lista de inicializadores std::initializer_list.
|
Valor de retorno
1,2)
c.rend()3)
std::reverse_iterator<T*>(array)4)
std::reverse_iterator<const T*>(il.begin())5)
c.rend()Excepciones
Puede lanzar excepciones definidas por la implementación.
Sobrecargas
Pueden proporcionarse sobrecargas personalizadas de rend para clases que no exponen una función miembro rend() adecuada, y que sin embargo pueden iterarse.
|
Las sobrecargas de |
(desde C++20) |
Ejemplo
Ejecuta este código
#include <algorithm>
#include <iostream>
#include <iterator>
#include <vector>
int main()
{
int a[]{4, 6, -3, 9, 10};
std::cout << "Array `a` estilo C invertido: ";
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` invertida: ";
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` invertido: ";
std::copy(std::rbegin(v), std::rend(v), std::ostream_iterator<int>(std::cout, " "));
std::cout << '\n';
}
Salida:
Array `a` estilo C invertido: 10 9 -3 6 4
std::initializer_list `il` invertida: 4 1 3
std::vector `v` invertido: 10 9 -3 6 4
Véase también
(C++11)(C++14) |
Devuelve un iterator al final de un contenedor o array (plantilla de función) |
(C++14) |
Devuelve un iterador inverso al contenedor o array (plantilla de función) |
(C++11)(C++14) |
Devuelve un iterator al comienzo de un contenedor o array. (plantilla de función) |
(C++20) |
Devuelve un iterador final inverso a un rango (objeto punto de personalización) |
(C++20) |
Devuelve un iterador inverso al final de un rango de solo lectura (objeto punto de personalización) |