std::stack<T,Container>::top

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (C++11)

技术规范

符号索引

外部库

 

容器库

顺序容器

array (C++11)

vector

deque

forward_list (C++11)

list

关联容器

set

multiset

map

multimap

无序关联容器

unordered_set (C++11)

unordered_multiset (C++11)

unordered_map (C++11)

unordered_multimap (C++11)

容器适配器

stack

queue

priority_queue

flat_set (C++23)

flat_multiset (C++23)

flat_map (C++23)

flat_multimap (C++23)

视图

span (C++20)

mdspan (C++23)

迭代器失效

成员函数表格

非成员函数表格

 

std::stack

成员函数

stack::stack

stack::~stack

stack::operator=

元素访问

stack::top

容量

stack::empty

stack::size

修改器

stack::push

stack::emplace (C++11)

stack::pop

stack::swap (C++11)

非成员函数

operator==operator!=operator<operator>operator<=operator>=operator<=> (C++20)

std::swap (C++11)

推导指引(C++17)

 

reference top();
const_reference top() const;

返回 stack 中顶元素的引用。它是最近推入的元素。此元素将在调用 pop() 时被移除。等效于调用 c.back() 。

参数

（无）

返回值

到末尾元素的引用

复杂度

常数

示例

运行此代码

#include <stack>
#include <iostream>
 
int main()
{
    std::stack<int>   s;
 
    s.push( 2 );
    s.push( 6 );
    s.push( 51 );
 
    std::cout << s.size() << " elements on stack\n";
    std::cout << "Top element: "
	      << s.top()         // 保留元素在 stack 上
	      << "\n";
    std::cout << s.size() << " elements on stack\n";
    s.pop();
    std::cout << s.size() << " elements on stack\n";
    std::cout << "Top element: " << s.top() << "\n";
 
    return 0;
}

输出：

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

参阅

push	向栈顶插入元素 (公开成员函数)
pop	删除栈顶元素 (公开成员函数)