Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

Fontes