Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::begin: iteratore iniziale di un contenitore o array

std::begin uniforma l’ottenimento del primo iteratore di un contenitore e del puntatore al primo elemento di un array nativo.

Versione: C++23

Sintassi

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) di <iterator> chiama range.begin() per un contenitore preservando la constness e, per un array nativo T[N], restituisce un T* al primo elemento. Non dereferenzia l’intervallo e funziona anche se è vuoto.

Nel codice generico, using std::begin; begin(x); introduce le funzioni libere standard nell’insieme degli overload, mentre la chiamata non qualificata consente ad ADL di aggiungere quella di un tipo utente. Gli array nativi come int[] non hanno alcun membro begin() e ADL da solo non trova per essi l’overload in std; la dichiarazione using è quindi necessaria.

Per un intervallo vuoto il risultato è uguale a std::end(range) e non va dereferenziato. Un iteratore ottenuto da un contenitore temporaneo può diventare pendente dopo l’espressione completa; std::begin non protegge la durata. Anche operazioni successive possono invalidarlo.

Esempi

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

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

Risultato

2

std::begin → 2

Fonti