Namespaces
Variants

    std::vector<T,Allocator>:: front

    From fr.cppreference.net

    C++
    Containers library
    std::vector
    Member types
    Member functions
    Non-member functions
    (until C++20) (until C++20) (until C++20) (until C++20) (until C++20)
    Deduction guides (C++17)
    reference front ( ) ;
    		(1) (constexpr depuis C++20)
    const_reference front ( ) const ;
    		(2) (constexpr depuis C++20)

    Retourne une référence au premier élément du conteneur.

    Si empty() est true , le comportement est indéfini.

    		(jusqu'à C++26)

    Si empty() est true :

    • Si l'implémentation est hardened , une contract violation se produit. De plus, si le gestionnaire de violation de contrat retourne sous la sémantique d'évaluation "observe", le comportement est indéfini.
    • Si l'implémentation n'est pas hardened, le comportement est indéfini.
    		(depuis C++26)

    Sommaire

    Valeur de retour

    Référence au premier élément.

    Complexité

    Constante.

    Notes

    Pour un conteneur c , l'expression c. front ( ) est équivalente à * c. begin ( ) .

    Exemple

    Le code suivant utilise front pour accéder au premier élément d'un std::vector<char> :

    Exécuter ce code
    #include <cassert>
#include <vector>
 
int main()
{
    std::vector<char> letters{'a', 'b', 'c', 'd'};
    assert(letters.front() == 'a');
}

    Voir aussi

    		accéder au dernier élément
    (fonction membre publique)
    (C++11)
    		retourne un itérateur inverse vers la fin
    (fonction membre publique)
    (C++11)
    		retourne un itérateur vers le début
    (fonction membre publique)
    		accès direct au stockage contigu sous-jacent
    (fonction membre publique)