Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

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
       recently	pushed
	  element. This	element	will be	removed	on a  call  to	pop().	Effec-
       tively calls
	  c.back().

Parameters
	  (none)

Return value
	  Reference to the last	element

Complexity
	  Constant

Example
       // Run this code

	#include <stack>
	#include <iostream>

	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		  2022.07.31		    std::stack::top(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=std::stack::top&sektion=3&manpath=FreeBSD+Ports+15.0>

home | help