Partager via


queue::front

Retourne une référence au premier élément au début de la file d'attente.

reference front( );
const_reference front( ) const;

Valeur de retour

Le premier élément dans la file d'attente. Si la file d'attente est vide, la valeur de retour est pas définie.

Notes

Si la valeur de retour d'front est affectée à const_reference, l'objet fin ne peut pas être modifié. Si la valeur de retour d'front est affectée à référence, l'objet fin peut être modifié.

La fonction retourne référence membre dans le premier élément dans la séquence contrôlée, qui doit être vide.

Lorsque vous compilez avec le _SECURE_SCL 1, une erreur d'exécution se produit si vous tentez d'accéder à un élément dans une file d'attente vide. Pour plus d'informations, consultez Itérateurs vérifiés.

Exemple

// queue_front.cpp
// compile with: /EHsc
#include <queue>
#include <iostream>

int main() {
   using namespace std;
   queue <int> q1;

   q1.push( 10 );
   q1.push( 20 );
   q1.push( 30 );

   queue <int>::size_type i;
   i = q1.size( );
   cout << "The queue length is " << i << "." << endl;

   int& ii = q1.back( );
   int& iii = q1.front( );

   cout << "The integer at the back of queue q1 is " << ii 
        << "." << endl;
   cout << "The integer at the front of queue q1 is " << iii 
        << "." << endl;
}

Sortie

The queue length is 3.
The integer at the back of queue q1 is 30.
The integer at the front of queue q1 is 10.

Configuration requise

**En-tête :**file d'attente <de >

Espace de noms : std

Voir aussi

Référence

queue, classe

queue, fonctions

Bibliothèque STL (Standard Template Library)