Namespaces
Variants

    std::ranges::cbegin

    De fr.cppreference.net
     
    C++
    Support du compilateur
    Autonome et hébergé
    Langage
    Bibliothèque standard
    En-têtes de la bibliothèque standard
    Exigences nommées
    Macros de test de fonctionnalités (depuis C++20)
    Bibliothèque de support du langage
    Bibliothèque des concepts (depuis C++20)
    Bibliothèque de diagnostics
    Bibliothèque de gestion de la mémoire
    Bibliothèque de métaprogrammation (depuis C++11)
    Bibliothèque d'utilitaires généraux
    Bibliothèque de conteneurs
    Bibliothèque d'itérateurs
    Bibliothèque des plages (depuis C++20)
    Bibliothèque d'algorithmes
    Bibliothèque de chaînes
    Bibliothèque de traitement de texte
    Bibliothèque numérique
    Bibliothèque de date et heure
    Bibliothèque d'entrée/sortie
    Bibliothèque du système de fichiers (depuis C++17)
    Bibliothèque de support de la concurrence (depuis C++11)
    Bibliothèque de contrôle d'exécution (depuis C++26)
    Spécifications techniques
    Index des symboles
    Bibliothèques externes
     
    Bibliothèque des plages
    Adaptateurs de plages
    (depuis C++23)(depuis C++23)
    (depuis C++23)
    (depuis C++23)(depuis C++23)
    (depuis C++23)
    (depuis C++23)(depuis C++23)
    (depuis C++23)(depuis C++23)
    (depuis C++23)(depuis C++23)
    (depuis C++23)(depuis C++23)
    (depuis C++23)(depuis C++23)

     
    Défini dans l'en-tête <ranges>
    Défini dans l'en-tête <iterator> 
    inline namespace /* unspecified */ {
    inline constexpr /* unspecified */ cbegin = /* unspecified */;
}
    		(depuis C++20)
    (objet point de personnalisation)
    Signature d'appel
    		 
    template< class T >
    requires /* see below */
constexpr /* see below */ auto cbegin( T&& t );
    		(depuis C++20)

    Renvoie un itérateur vers le premier élément de l'argument qualifié const.

    		(jusqu'à C++23)

    Renvoie un itérateur constant vers le premier élément de l'argument.

    		(depuis C++23)

    Soit CT être

    • const std::remove_reference_t<T>& si l'argument est une lvalue (c'est-à-dire que T est un type de référence lvalue),
    • const T sinon.

    Un appel à ranges::cbegin est équivalent à une expression à ranges::begin(static_cast<CT&&>(t)).

    		(jusqu'à C++23)

    Si l'argument est une lvalue ou que ranges::enable_borrowed_range<std::remove_cv_t<T>> est true, alors un appel à ranges::cbegin est équivalent à une expression à :

    • std::const_iterator<decltype(U)>(U) pour une expression U équivalente à ranges::begin(possibly-const-range(t).

    Dans tous les autres cas, un appel à ranges::cbegin est mal formé, ce qui peut entraîner un échec de substitution lorsque l'appel apparaît dans le contexte immédiat d'une instanciation de modèle.

    		(depuis C++23)

    Le type de retour modélise std::input_or_output_iterator et constant-iterator(depuis C++23) dans tous les cas.

    Objets de point de personnalisation

    Le nom ranges::cbegin désigne un objet de point de personnalisation , qui est un objet fonction const d'un type de classe littéral semiregular . Voir CustomizationPointObject pour plus de détails.

    Notes

    Pour une plage lvalue e de type T , ranges :: cbegin ( e ) est équivalent à

    ranges:: begin ( std:: as_const ( e ) ) .

    		(jusqu'à C++23)
    (depuis C++23)

    Exemple

    Exécuter ce code 
    #include <cassert>
#include <ranges>
#include <vector>
int main()
{
    std::vector v{3, 1, 4};
    auto vi = std::ranges::cbegin(v);
    assert(3 == *vi);
    ++vi; // OK, l'objet itérateur constant est mutable
    assert(1 == *vi);
    // *vi = 13; // Erreur : l'itérateur constant pointe vers un élément immuable
    int a[]{3, 1, 4};
    auto ai = std::ranges::cbegin(a); // cbegin fonctionne également avec les tableaux C
    assert(3 == *ai and *(ai + 1) == 1);
    // *ai = 13; // Erreur : variable en lecture seule non assignable
}

    Voir aussi

    (C++20)
    		retourne un itérateur vers le début d'une plage
    (objet de point de personnalisation)
    (C++11) (C++14)
    		retourne un itérateur vers le début d'un conteneur ou d'un tableau
    (fonction template)