C++官网参考链接:https://cplusplus.com/reference/list/list/front/
公有成员函数
<list>
std::list::front
reference front();
const_reference front() const;
访问第一个元素
返回list容器中第一个元素的reference。
与返回指向同一元素的iterator的成员list::begin不同,此函数返回直接reference。
在empty容器上调用此函数会导致未定义的行为。
形参
没有形参。
返回值
对list容器中第一个元素的reference。
如果list对象是const限定的,函数返回一个const_reference。否则,它返回一个reference。
成员类型reference和const_reference是容器元素的reference类型(参见list成员类型(list member types))。
用例
// list::front
#include <iostream>
#include <list>
int main ()
{
std::list<int> mylist;
mylist.push_back(77);
mylist.push_back(22);
// now front equals 77, and back 22
mylist.front() -= mylist.back();
std::cout << "mylist.front() is now " << mylist.front() << '\n';
return 0;
}
输出:
复杂度
常数。
iterator的有效性
没有变化。
数据竞争
容器被访问(const和non-const版本都不会修改容器)。
第一个元素可能由调用者访问或修改。同时访问或修改其他元素是安全的。
异常安全
如果容器不为empty,则函数永远不会抛出异常(无抛出保证)。
否则,它将导致未定义的行为。