std::ranges::cend

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

Sea CT

1. const std::remove_reference_t<T>& si el argumento es un l-valor (es decir, T es un tipo referencia a l-valor),
2. 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)).

[editar] 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.

[editar] 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.

[editar] 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";
    }
}

se encontró un 5 en el array a

[editar] Véase también