std::
stack::top
公共成员函数 <stack>
C++98; |
value_type& top();
const value_type& top() const; |
C++11; |
reference top();
const_reference top() const; |
返回对栈顶元素的引用
返回对栈顶元素的引用。
由于栈是后进先出的容器,所以顶层元素是插入栈的最后一个元素。
此函数调用底层容器对象的成员back。
☲ 参数
-
none
☉ 返回值
对栈顶元素的引用。
-
c++98
-
成员类型value_type是容器中元素的类型(定义为第一个类模板形参T的别名)。
-
c++11
-
成员类型reference和const_reference是具有相同名称的底层容器类型的别名。
☣ 示例
// stack::top
#include <iostream> // std::cout
#include <stack> // std::stack
int main ()
{
std::stack<int> mystack;
mystack.push(10);
mystack.push(20);
mystack.top() -= 5;
std::cout << "mystack.top() is now " << mystack.top() << '\n';
return 0;
} |
输出:
mystack.top() is now 15
✥ 复杂度
常量(调用底层容器back)。
⇄ 数据竞争
容器被访问(const和非const版本都不会修改容器)。
返回的引用可用于访问或修改顶部元素。
☂ 异常安全性
提供与在容器上执行的操作相同级别的保证(对于标准容器类型无抛出保证)。
🍄 另请参阅
stack::pop |
删除元素(公众成员函数) |
stack::push |
插入元素(公众成员函数) |