stack::top

Artikel
06/09/2015

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

reference top( );
const_reference top( ) const;

Rückgabewert

Ein Verweis auf das letzte Element im Container am Anfang des Stapels.

Hinweise

Der Stapel muss nicht leer sein, die Memberfunktion zu übernehmen. Oben im Stapel entspricht der Position, die zuletzt von das hinzugefügte Element eingenommen wurde und das letzte Element am Ende des Containers.

Wenn const_reference der Rückgabewert von oben zugewiesen ist, kann das Stapelobjekt nicht geändert werden. Wenn Verweis der Rückgabewert von oben zugewiesen ist, 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;
}