vector::front

Retourne une référence au premier élément d'un vecteur.

reference front( );  const_reference front( ) const;

Valeur de retour

Référence au premier élément du vecteur. Si le vecteur est vide, la valeur de retour n'est pas définie.

Notes

Si la valeur de retour de front est assignée à const_reference, il est impossible de modifier l'objet de vecteur. Si la valeur de retour de front est assignée à reference, le vecteur peut être modifié.

Dans le cadre d'une compilation avec _SECURE_SCL 1, une erreur d'exécution se produit si vous essayez d'accéder à un élément d'un vecteur vide. Pour plus d'informations, voir Itérateurs vérifiés.

Exemple

// vector_front.cpp
// compile with: /EHsc
#include <vector>
#include <iostream>
using namespace std;  
int main( )
{
  vector <int> vec;
    vec.push_back(10);
    vec.push_back(20);

    int& i = vec.front();
    const int& ci = vec.front();

    cout << "The value of vec[0] is " << i << endl;

    // front() returns a reference, not an iterator
    // by incrementing i, we change the value of the first element
    i++;
    cout << "Now, the value of vec[0] is " << i << endl;

   // ci++; compiler error because ci is const}

Sortie

The first integer of v1 is 10
Now, the first integer of v1 is 11

Configuration requise

En-tête : <vector>

Espace de noms : std

Voir aussi

Référence

vector, classe

vector::front et vector::back

Bibliothèque STL (Standard Template Library)