CKTIS / C++
std::begin: beginiterator van een container of array
std::begin biedt één manier om de eerste iterator van een container of een pointer naar het eerste element van een ingebouwde array te krijgen.
Versie: 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) uit <iterator> roept voor een container range.begin() aan met behoud van constness en retourneert voor een ingebouwde array T[N] een T* naar het eerste element. Het bereik wordt niet gederefereerd en mag leeg zijn.
In generieke code brengt using std::begin; begin(x); de vrije standaardfuncties in de overloadset, terwijl de ongekwalificeerde aanroep ADL een functie van het gebruikerstype laat toevoegen. Ingebouwde arrays zoals int[] hebben helemaal geen begin()-lid en ADL alleen vindt voor hen de overload in std niet; daarom is de using-declaratie nodig.
Bij een leeg bereik is het resultaat gelijk aan std::end(range) en mag het niet worden gederefereerd. Een iterator van een tijdelijke container kan na de volledige expressie hangen; std::begin beschermt de levensduur niet. Latere containerbewerkingen kunnen hem eveneens ongeldig maken.
Voorbeelden
#include <array>
#include <iostream>
#include <iterator>
int main() {
const std::array values{2, 5};
std::cout << *std::begin(values) << '\n';
}
Resultaat
2
std::begin → 2