std::stack<T,Container>::top - cppreference.com (original) (raw)

| reference top(); | (1) | | | ----------------------------- | --- | | | const_reference top() const; | (2) | |

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(). Equivalent to: c.back().

[edit] Parameters

(none)

[edit] Return value

Reference to the last element.

[edit] Complexity

Constant.

[edit] Example

#include #include   void reportStackSize(const std::stack& s) { std::cout << s.size() << " elements on stack\n"; }   void reportStackTop(const std::stack& s) { // Leaves element on stack std::cout << "Top element: " << s.top() << '\n'; }   int main() { std::stack 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

[edit] See also

| | inserts element at the top (public member function) [edit] | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | | removes the top element (public member function) [edit] |