std::ranges::crend
| Definido en el archivo de encabezado <ranges>
|
||
inline namespace /*no especificado*/ { inline constexpr /*no especificado*/ crend = /*no especificado*/; } |
(desde C++20) (objeto punto de personalización) |
|
| Signatura de la llamada |
||
template< class T > requires /* véase a continuación */ constexpr std::sentinel_for<ranges::iterator_t<T>> auto crend( T&& t ); |
(desde C++20) | |
Devuelve un centinela que indica el fin de un rango calificado const, que se trata como una secuencia inversa.
Sea CT
const std::remove_reference_t<T>&si el argumento es un l-valor (es decir,Tes un tipo referencia a l-valor),const Tde lo contrario,
una llamada a ranges::crend es equivalente en expresión a ranges::rend(static_cast<CT&&>(t)).
Si ranges::crend(e) es válido para una expresión e, entonces std::sentinel_for<S, I> es true en todos los casos, donde S es decltype(ranges::crend(e)), e I es decltype(ranges::crbegin(e)).
Equivalente en expresión
La expresión e es equivalente-en-expresión a la expresión f, si e y f tienen los mismos efectos, ambas potencialmente lanzan o ambas potencialmente no lanzan (es decir, noexcept (e) == noexcept(f)), y ambas son subexpresiones constantes o ambas no son subexpresiones constantes.
Objetos de punto de personalización
El nombre ranges::crend denota un objeto de punto de personalización, que es un objeto función const de un tipo clase literal semiregular (denotado, a efectos de exposición, como crend_ftor). Todos los ejemplares de crend_ftor son iguales. Por lo tanto, ranges::crend puede copiarse libremente y sus copias pueden usarse indistintamente.
Dado un conjunto de tipos Args..., si std::declval<Args>()... cumple con los requerimientos para los argumentos de ranges::crend mencionado anteriormente, crend_ftor satisfará a std::invocable<const crend_ftor&, Args...>. De lo contrario, ningún operador de llamada a función de crend_ftor participa en la resolución de sobrecarga.
Ejemplo
#include <iostream>
#include <vector>
#include <iterator>
#include <algorithm>
int main()
{
int a[] = {4, 6, -3, 9, 10};
std::cout << "array invertido: ";
namespace ranges = std::ranges;
ranges::copy(ranges::rbegin(a), ranges::rend(a),
std::ostream_iterator<int>(std::cout, " "));
std::cout << "\nvector invertido: ";
std::vector<int> v = {4, 6, -3, 9, 10};
ranges::copy(ranges::rbegin(v), ranges::rend(v),
std::ostream_iterator<int>(std::cout, " "));
}
Salida:
array invertido: 10 9 -3 6 4
vector invertido: 10 9 -3 6 4
Véase también
(C++20) |
Devuelve un iterador final inverso a un rango (objeto punto de personalización) |
(C++14) |
Devuelve un iterador inverso al final para un contenedor o array (plantilla de función) |