Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::begin : itérateur de début d’un conteneur ou tableau

std::begin unifie l’obtention du premier itérateur d’un conteneur et du pointeur vers le premier élément d’un tableau natif.

Version : C++23

Syntaxe

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) de <iterator> appelle range.begin() pour un conteneur en conservant la constance et, pour un tableau natif T[N], renvoie un T* vers le premier élément. Il ne déréférence pas la plage et accepte une plage vide.

Dans du code générique, using std::begin; begin(x); introduit les fonctions libres standard dans l’ensemble des surcharges, tandis que l’appel non qualifié permet à ADL d’ajouter celle d’un type utilisateur. Les tableaux natifs comme int[] n’ont aucun membre begin() et ADL seul ne trouve pas pour eux la surcharge de std ; la déclaration using est donc importante.

Pour une plage vide, le résultat égale std::end(range) et ne doit pas être déréférencé. Un itérateur d’un conteneur temporaire peut pendre après l’expression complète ; std::begin ne protège pas sa durée de vie. Les opérations du conteneur peuvent aussi l’invalider.

Exemples

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

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

Résultat

2

std::begin → 2

Sources