std:: end, std:: cend

Retourne un itérateur vers la fin (c'est-à-dire l'élément après le dernier élément) de la plage donnée.

Paramètres

Valeur de retour

Exceptions

Surcharges

Des surcharges personnalisées de end peuvent être fournies pour les classes et les énumérations qui n'exposent pas de fonction membre end() appropriée, mais qui peuvent être parcourues. Les surcharges suivantes sont déjà fournies par la bibliothèque standard :

Similaire à l'utilisation de swap (décrite dans Swappable ), l'utilisation typique de la fonction end dans un contexte générique équivaut à using std :: end ; end ( arg ) ; , ce qui permet à la fois aux surcharges sélectionnées par ADL pour les types définis par l'utilisateur et aux modèles de fonctions de la bibliothèque standard d'apparaître dans le même ensemble de surcharges.

template<typename Container, typename Function>
void for_each(Container&& cont, Function f)
{
    using std::begin;
    auto it = begin(cont);
    using std::end;
    auto end_it = end(cont);
    for (; it != end_it; ++it)
        f(*it);
}

Notes

Les surcharges non-tableau reflètent exactement le comportement de C :: end ( ) . Leurs effets peuvent être surprenants si la fonction membre n'a pas d'implémentation raisonnable.

std::cend est introduit pour l'unification des accès aux plages membres et non membres. Voir aussi LWG issue 2128 .

Si C est une vue à constance superficielle, std::cend peut renvoyer un itérateur mutable. Ce comportement est inattendu pour certains utilisateurs. Voir également P2276 et P2278 .

Exemple

#include <algorithm>
#include <iostream>
#include <vector>
int main()
{
    std::vector<int> v = {3, 1, 4};
    if (std::find(std::begin(v), std::end(v), 5) != std::end(v))
        std::cout << "Found a 5 in vector v!\n";
    int w[] = {5, 10, 15};
    if (std::find(std::begin(w), std::end(w), 5) != std::end(w))
        std::cout << "Found a 5 in array w!\n";
}

Found a 5 in array w!

Voir aussi