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

CKTIS / C++

std::end : itérateur après la fin de la plage

std::end renvoie l’itérateur past-the-end d’un conteneur ou un pointeur juste après un tableau natif.

Version : C++23

Syntaxe

template<class C>
constexpr auto end(C& c) -> decltype(c.end());

template<class T, std::size_t N>
constexpr T* end(T (&array)[N]) noexcept;

std::end(c) de <iterator> appelle c.end() et préserve exactement son type de retour, mais C++23 n’impose pas noexcept à cette surcharge. Pour un tableau natif T array[N], une surcharge distincte renvoie array + N et est noexcept.

La position rendue est la borne droite exclue de [begin, end) et ne doit pas être déréférencée. Elle égale le début pour une plage vide. Sa validité et son invalidation suivent l’objet source ; un itérateur survivant à son conteneur est pendant.

std::end(x) qualifié traite les types dotés d’un membre end() et les tableaux natifs. En code générique, using std::end; end(x); permet aussi à ADL de trouver une surcharge libre propre au type. Ne le confonds pas avec std::ranges::end, dont les règles de range et de sentinel diffèrent.

Exemples

#include <iostream>
#include <iterator>

int main() {
    int values[]{4, 7, 9};
    const auto last = std::end(values);
    std::cout << (last - std::begin(values)) << ' ' << *(last - 1) << '\n';
}

Résultat

3 9

std::end → 3 9

Sources