CKTIS / C++
std::end: iterador após o fim do intervalo
std::end devolve o iterador past-the-end de um contentor ou um ponteiro após um array incorporado.
Versão: C++23
Sintaxe
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>, chama c.end() e preserva exatamente o tipo devolvido, mas C++23 não exige noexcept nesta sobrecarga. Para um array incorporado T array[N], uma sobrecarga separada devolve array + N e é noexcept.
A posição devolvida é o limite direito exclusivo de [begin, end) e não pode ser desreferenciada. Num intervalo vazio coincide com o início. A sua validade e invalidação dependem do objeto de origem; um iterador que sobreviva ao contentor fica pendente.
std::end(x) qualificado trata tipos com membro end() e arrays incorporados. Em código genérico, using std::end; end(x); permite ainda a ADL encontrar uma sobrecarga livre personalizada. Não o confundas com std::ranges::end, que tem regras próprias de ranges e sentinelas.
Exemplos
#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