stack::top

Articolo
03/26/2013

Restituisce un riferimento a un elemento all'inizio dello stack.

reference top( );
const_reference top( ) const;

Valore restituito

Un riferimento all'ultimo elemento nel contenitore all'inizio dello stack.

Note

Lo stack non deve essere vuoto applicare la funzione membro.La parte superiore dello stack è la posizione occupata dall'elemento che è stato appena aggiunto ed è l'ultimo elemento alla fine del contenitore.

Se il valore restituito top viene assegnato a const_reference, l'oggetto dello stack non può essere modificato.Se il valore restituito top viene assegnato a reference, l'oggetto dello stack può essere modificato.

Esempio

// 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;
}