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