WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::end: Iterator hinter dem Bereich

std::end liefert den Past-the-end-Iterator eines Containers oder einen Zeiger hinter einer eingebauten Arraygrenze.

Version: 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) aus <iterator> ruft c.end() auf und bewahrt den genauen Rückgabetyp, doch C++23 schreibt für diesen Overload kein noexcept vor. Für ein eingebautes Array T array[N] liefert ein eigener noexcept-Overload array + N.

Die Rückgabe ist die exklusive rechte Grenze von [begin, end) und darf nicht dereferenziert werden. Bei einem leeren Bereich entspricht sie dem Anfang. Gültigkeit und Invalidierung folgen dem Quellobjekt; überlebt der Iterator seinen Container, ist er ungültig.

Qualifiziertes std::end(x) unterstützt Typen mit Member end() und eingebaute Arrays. In generischem Code erlaubt using std::end; end(x); zusätzlich, einen freien eigenen Overload per ADL zu finden. Dies ist nicht std::ranges::end, das eigene Bereichs- und Sentinelregeln besitzt.

Beispiele

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

Ergebnis

3 9

std::end → 3 9

Quellen