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