std::ranges::cend - cppreference.com

De cppreference.com

Definido en el archivo de encabezado `<ranges>`
`inline namespace /no especificado/ { inline constexpr /no especificado/ cend = /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 cend( T&& t );`		(desde C++20)

Devuelve un centinela que indica el fin de un rango calificado const.

Sea CT

const std::remove_reference_t<T>& si el argumento es un l-valor (es decir, T es un tipo referencia a l-valor),
const T de lo contrario,

una llamada a ranges::cend es equivalente en expresión a ranges::end(static_cast<CT&&>(t)).

Si ranges::cend(e) es válido para una expresión e, donde decltype((e)) es T, entonces CT modela std::ranges::range, y std::sentinel_for<S, I> es true en todos los casos, donde S es decltype(ranges::cend(e)), e I es decltype(ranges::cbegin(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::cend 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 cend_ftor). Todos los ejemplares de cend_ftor son iguales. Por lo tanto, ranges::cend 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::cend mencionado anteriormente, cend_ftor satisfará a std::invocable<const cend_ftor&, Args...>. De lo contrario, ningún operador de llamada a función de cend_ftor participa en la resolución de sobrecarga.

Ejemplo

#include <algorithm>
#include <iostream>
#include <ranges>
#include <vector>

int main() 
{
    std::vector<int> v = { 3, 1, 4 };
    namespace ranges = std::ranges;
    if (ranges::find(v, 5) != ranges::cend(v)) {
        std::cout << "se encontró un 5 en el vector v\n";
    }

    int a[] = { 5, 10, 15 };
    if (ranges::find(a, 5) != ranges::cend(a)) {
        std::cout << "se encontró un 5 en el array a\n";
    }
}

Salida:

se encontró un 5 en el array a

Véase también

	Devuelve un iterador al final de un rango (objeto punto de personalización) [editar]
	Devuelve un iterator al final de un contenedor o array (plantilla de función) [editar]