stack::top

Artigo
03/14/2013

Retorna uma referência a um elemento na parte superior de pilha.

reference top( );
const_reference top( ) const;

Valor de retorno

Uma referência para o último elemento no recipiente na parte superior de pilha.

Comentários

A pilha deve ser não vazio aplicar a função de membro.A parte superior da pilha é a posição ocupada pelo elemento recém adicionado e é o último elemento no final do contêiner.

Se o valor de retorno de top é atribuído a const_reference, o objeto de pilha não pode ser alterado.Se o valor de retorno de top é atribuído a reference, o objeto de pilha pode ser alterado.

Exemplo

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