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