home | help 
std::stack::top(3)	       C++ Standard Libary	      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 re-
     cently 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)

http://cppreference.com 	   2024.06.10		      std::stack::top(3)
home | help