std::stack::top(3)

NAME
std::stack::top - std::stack::top

Synopsis
   reference top();
   const_reference top() const;
   Returns reference to the top element in the stack. This is the most recently pushed
   element. This element will be removed on a call to pop(). Effectively calls
   c.back().

Parameters
   (none)

Return value
   Reference to the last element.

Complexity
   Constant.

Example
// Run this code
 #include <iostream>
 #include <stack>
 void reportStackSize(const std::stack<int>& s)
 {
     std::cout << s.size() << " elements on stack\n";
 }
 void reportStackTop(const std::stack<int>& s)
 {
     // Leaves element on stack
     std::cout << "Top element: " << s.top() << '\n';
 }
 int main()
 {
     std::stack<int> s;
     s.push(2);
     s.push(6);
     s.push(51);
     reportStackSize(s);
     reportStackTop(s);
     reportStackSize(s);
     s.pop();
     reportStackSize(s);
     reportStackTop(s);
 }

Output:
 3 elements on stack
 Top element: 51
 3 elements on stack
 2 elements on stack
 Top element: 6

See also
   push inserts element at the top
        (public member function)
   pop removes the top element
        (public member function)