stack::top

Article
03/26/2013

Retourne une référence à un élément en haut de la pile.

reference top( );
const_reference top( ) const;

Valeur de retour

Une référence au dernier élément dans le conteneur en haut de la pile.

Notes

La pile doit être vide pour appliquer la fonction membre.En haut de la pile est la position occupée par l'élément récemment ajouté et est le dernier élément à la fin de le conteneur.

Si la valeur de retour de top est assignée à const_reference, l'objet de pile ne peut pas être modifié.Si la valeur de retour de top est assignée à reference, l'objet de pile peut être modifié.

Exemple

// stack_top.cpp
// compile with: /EHsc
#include <stack>
#include <iostream>

int main( )
{
   using namespace std;
   stack <int> s1;
   
   s1.push( 1 );
   s1.push( 2 );

   int& i = s1.top( );
   const int& ii = s1.top( );

   cout << "The top integer of the stack s1 is "
        << i << "." << endl;
   i--;
   cout << "The next integer down is "<< ii << "." << endl;
}