stack::top

Artikel
03/26/2013

Gibt einen Verweis auf ein Element am Anfang des Stapels zurück.

reference top( );
const_reference top( ) const;

Rückgabewert

Ein Verweis auf den letzten Element im Container am Anfang des Stapels.

Hinweise

Der Stapel muss nicht leer sein, die Memberfunktion anzuwenden.Die Rand des Stapels ist die Position, die zuletzt vom hinzugefügte Element eingenommen wurde und das letzte Element am Ende des Containers.

Wenn const_reference der Rückgabewert von top zugewiesen wird, kann das Stapelobjekt nicht geändert werden.Wenn reference der Rückgabewert von top zugewiesen wird, kann das Stapelobjekt geändert werden.

Beispiel

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