C++ Reference: Standard C++ Library reference: Containers: list: list: front

C++官网参考链接：https://cplusplus.com/reference/list/list/front/

公有成员函数 

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
#include

int main ()
{
  std::list 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，则函数永远不会抛出异常（无抛出保证）。
否则，它将导致未定义的行为。