Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C++

std::end: iterador posterior al rango

std::end devuelve el iterador past-the-end de un contenedor o un puntero posterior a un array incorporado.

Versión: C++23

Sintaxis

template<class C>
constexpr auto end(C& c) -> decltype(c.end());

template<class T, std::size_t N>
constexpr T* end(T (&array)[N]) noexcept;

std::end(c), de <iterator>, llama a c.end() y conserva exactamente su tipo de retorno, pero C++23 no exige que esta sobrecarga sea noexcept. Para un array incorporado T array[N], otra sobrecarga devuelve array + N y es noexcept.

La posición devuelta es el límite derecho exclusivo de [begin, end) y no puede desreferenciarse. Coincide con el principio en un rango vacío. Su validez e invalidación dependen del objeto origen; un iterador que sobrevive al contenedor queda colgante.

std::end(x) cualificado admite tipos con miembro end() y arrays incorporados. En código genérico, using std::end; end(x); permite además que ADL encuentre una sobrecarga libre personalizada. No se debe confundir con std::ranges::end, que tiene reglas propias de rangos y sentinelas.

Ejemplos

#include <iostream>
#include <iterator>

int main() {
    int values[]{4, 7, 9};
    const auto last = std::end(values);
    std::cout << (last - std::begin(values)) << ' ' << *(last - 1) << '\n';
}

Resultado

3 9

std::end → 3 9

Fuentes