WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::begin: Startiterator eines Containers oder Arrays

std::begin vereinheitlicht den ersten Iterator eines Containers und den Zeiger auf das erste Element eines eingebauten Arrays.

Version: C++23

Syntax

template<class C>
constexpr auto begin(C& container) -> decltype(container.begin());

template<class C>
constexpr auto begin(const C& container) -> decltype(container.begin());

template<class T, std::size_t N>
constexpr T* begin(T (&array)[N]) noexcept;

std::begin(range) aus <iterator> ruft bei einem Container unter Erhalt der Const-Eigenschaft range.begin() auf und liefert bei einem eingebauten Array T[N] einen T* auf das erste Element. Der Bereich wird nicht dereferenziert; auch leere Bereiche sind zulässig.

In generischem Code bringt using std::begin; begin(x); die freien Standardfunktionen in die Overloadmenge, während der unqualifizierte Aufruf über ADL Funktionen eines Benutzertyps ergänzt. Eingebaute Arrays wie int[] haben überhaupt kein begin()-Member, und ADL allein findet für sie den Overload in std nicht; daher ist die using-Deklaration nötig.

Bei leerem Bereich ist das Ergebnis gleich std::end(range) und darf nicht dereferenziert werden. Ein Iterator aus einem temporären Container kann nach dem vollständigen Ausdruck hängen; std::begin schützt die Lebensdauer nicht. Containeroperationen können ihn später ebenfalls ungültig machen.

Beispiele

#include <array>
#include <iostream>
#include <iterator>

int main() {
    const std::array values{2, 5};
    std::cout << *std::begin(values) << '\n';
}

Ergebnis

2

std::begin → 2

Quellen