CKTIS / C++
std::begin: počiatočný iterátor kontajnera alebo poľa
std::begin zjednocuje získanie prvého iterátora kontajnera a ukazovateľa na prvý prvok vstavaného poľa.
Verzia: 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) z <iterator> zavolá pri kontajneri range.begin() so zachovaním constnosti a pri vstavanom poli T[N] vráti T* na prvý prvok. Rozsah nedereferencuje a funguje aj pre prázdny rozsah.
Vo všeobecnom kóde using std::begin; begin(x); zavedie štandardné voľné funkcie do množiny preťažení a nekvalifikované volanie dovolí ADL pridať funkciu používateľského typu. Vstavané polia ako int[] nemajú člen begin() a samotné ADL pre ne preťaženie v std nenájde, preto je deklarácia using dôležitá.
Pre prázdny rozsah sa výsledok rovná std::end(range) a nesmie sa dereferencovať. Iterátor z dočasného kontajnera môže po úplnom výraze visieť; std::begin životnosť nechráni. Neskoršie operácie kontajnera ho tiež môžu zneplatniť.
Príklady
#include <array>
#include <iostream>
#include <iterator>
int main() {
const std::array values{2, 5};
std::cout << *std::begin(values) << '\n';
}
Výsledok
2
std::begin → 2