stack::top

Artykuł
03/26/2013

Zwraca odwołanie do elementu na górze stosu.

reference top( );
const_reference top( ) const;

Wartość zwracana

Odwołanie do ostatniego elementu w pojemniku na wierzchu stosu.

Uwagi

Stos musi być niepusty zastosowania funkcji składowej.Wierzch stosu jest Stanowisko zajęte przez element ostatnio dodane i ostatni element na końcu pojemnika.

Jeśli wartość zwracana przez góry jest przypisany do const_reference, nie można modyfikować obiektów stosu.Jeśli wartość zwracana przez góry jest przypisany do odniesienia, obiekt stosu można modyfikować.

Przykład

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