stack::top

Artigo
06/09/2015

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

reference top( );
const_reference top( ) const;

Valor de retorno

Uma referência ao elemento o mais recente no contêiner na parte superior da pilha.

Comentários

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

Se o valor de retorno de top é atribuído a const_reference, o objeto da pilha não pode ser alterado. Se o valor de retorno de top é atribuído a reference, o objeto da 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;
}