stack::top

Artículo
06/09/2015

Devuelve una referencia a un elemento en la parte superior de la pila.

reference top( );
const_reference top( ) const;

Valor devuelto

Una referencia al último elemento del contenedor en la parte superior de la pila.

Comentarios

La pila no puede estar vacía aplicar la función miembro. La parte superior de la pila es la posición que ocupa el elemento recientemente agregado y es el último elemento al final del contenedor.

Si el valor devuelto de arriba se asigna a const_reference, el objeto de pila no puede modificarse. Si el valor devuelto de arriba se asigna a reference, el objeto de pila puede modificarse.

Ejemplo

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