(C++17) | ||||
| Sequence | ||||
(C++11) | ||||
(C++26) | ||||
(C++26) | ||||
(C++11) | ||||
| Associative | ||||
| Unordered associative | ||||
(C++11) | ||||
(C++11) | ||||
(C++11) | ||||
(C++11) | ||||
| Adaptors | ||||
(C++23) | ||||
(C++23) | ||||
(C++23) | ||||
(C++23) | ||||
| Views | ||||
(C++20) | ||||
(C++23) | ||||
| Tables | ||||
| Iterator invalidation | ||||
| Member function table | ||||
| Non-member function table |
std::stack| Member functions | ||||
| Element access | ||||
stack::top | ||||
| Capacity | ||||
| Modifiers | ||||
(C++23) | ||||
(C++11) | ||||
(C++11) | ||||
| Non-member functions | ||||
(C++11) | ||||
| Helper classes | ||||
(C++11) | ||||
(C++23) | ||||
| Deduction guides(C++17) |
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 topop(). Equivalent to:c.back().
Contents |
(none)
Reference to the last element.
Constant.
#include <iostream>#include <stack> void reportStackSize(conststd::stack<int>& s){std::cout<< s.size()<<" elements on stack\n";} void reportStackTop(conststd::stack<int>& s){// Leaves element on stackstd::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 stackTop element: 513 elements on stack2 elements on stackTop element: 6
| inserts element at the top (public member function)[edit] | |
| removes the top element (public member function)[edit] |