CKTIS / C++
std::begin: začetni iterator vsebnika ali tabele
std::begin poenoti pridobivanje prvega iteratorja vsebnika in kazalca na prvi element vgrajene tabele.
Različica: C++23
Sintaksa
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) iz <iterator> pri vsebniku pokliče range.begin() in ohrani constnost, pri vgrajeni tabeli T[N] pa vrne T* na prvi element. Obsega ne dereferencira in deluje tudi za prazen obseg.
V splošni kodi using std::begin; begin(x); v množico preobremenitev uvede proste standardne funkcije, nekvalificirani klic pa ADL dovoli dodati funkcijo uporabniškega tipa. Vgrajene tabele, kot je int[], sploh nimajo člana begin() in ADL sam zanje ne najde preobremenitve v std, zato je deklaracija using pomembna.
Pri praznem obsegu je rezultat enak std::end(range) in ga ne smemo dereferencirati. Iterator iz začasnega vsebnika lahko po celotnem izrazu obvisi; std::begin ne varuje življenjske dobe. Poznejše operacije vsebnika ga lahko tudi razveljavijo.
Primeri
#include <array>
#include <iostream>
#include <iterator>
int main() {
const std::array values{2, 5};
std::cout << *std::begin(values) << '\n';
}
Rezultat
2
std::begin → 2