Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::end: iteratore oltre la fine dell’intervallo

std::end restituisce l’iteratore past-the-end di un contenitore o il puntatore oltre un array incorporato.

Versione: C++23

Sintassi

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) di <iterator> chiama c.end() preservandone esattamente il tipo di ritorno, ma C++23 non impone noexcept a questo overload. Per un array incorporato T array[N], un overload separato restituisce array + N ed è noexcept.

La posizione restituita è il limite destro esclusivo di [begin, end) e non va dereferenziata. In un intervallo vuoto coincide con l’inizio. Validità e invalidazione dipendono dall’oggetto sorgente; un iteratore che sopravvive al contenitore è dangling.

std::end(x) qualificato gestisce tipi con membro end() e array incorporati. Nel codice generico, using std::end; end(x); consente anche ad ADL di trovare un overload libero personalizzato. Non confonderlo con std::ranges::end, che segue regole separate per range e sentinel.

Esempi

#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';
}

Risultato

3 9

std::end → 3 9

Fonti