public member function
<list>

std::list::front

      reference front();const_reference front() const;
访问第一个元素
返回对list容器中第一个元素的引用。

与返回指向同一元素的迭代器的成员函数list::begin不同,此函数直接返回引用。

容器调用此函数会导致未定义行为。

参数



返回值

对list容器中第一个元素的引用。

如果 list 对象是 const-qualified,则函数返回一个const_reference。否则,它返回一个引用.

成员类型引用const_reference是容器元素的引用类型(参见list成员类型)。

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
// 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;
}

输出
mylist.front() is now 55


复杂度

常量。

迭代器有效性

没有变化。

数据竞争

访问容器(const 和非 const 版本都不会修改容器)。
第一个元素可以被调用者访问或修改。同时访问或修改其他元素是安全的。

异常安全

如果容器不为空,则该函数永远不会抛出异常(无异常保证)。
否则,将导致未定义行为

另见