stack::top

Article
06/09/2015

Retourne une référence à un élément situé 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 situé en haut de la pile.

Notes

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

Si la valeur de retour de top est affectée à const_reference, l'objet de pile ne peut pas être modifié. Si la valeur de retour de top est affectée à référence, 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;
}