KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::end: iterator voorbij het bereik

std::end retourneert de past-the-end-iterator van een container of een pointer voorbij een ingebouwde array.

Versie: C++23

Syntax

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) uit <iterator> roept c.end() aan en behoudt het exacte resultaattype, maar C++23 schrijft voor deze overload geen noexcept voor. Voor een ingebouwde array T array[N] retourneert een aparte noexcept-overload array + N.

De teruggegeven positie is de exclusieve rechtergrens van [begin, end) en mag niet worden gedereferentieerd. Bij een leeg bereik is ze gelijk aan het begin. Geldigheid en invalidatie volgen het bronobject; een iterator die langer leeft dan zijn container hangt.

Gekwalificeerd std::end(x) behandelt typen met een end()-lid en ingebouwde arrays. In generieke code laat using std::end; end(x); ADL ook een vrije aangepaste overload vinden. Verwar dit niet met std::ranges::end, dat afzonderlijke regels voor ranges en sentinels heeft.

Voorbeelden

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

Resultaat

3 9

std::end → 3 9

Bronnen