std::

list::front

公众成员函数  <list>
访问首元素

返回对列表容器中第一个元素的引用。

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

在空容器上调用此函数将导致未定义的行为。

☲  参数

---

none

☉  返回值

---

容器中第一个元素的引用

如果list对象是const限定的，则函数返回一个const_reference。否则，它返回一个reference。

成员类型reference和const_reference是对容器元素的引用类型(参见列表成员类型)。

☣  示例

---

// 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; }

✥ 复杂度

---

常量

☣ 迭代器的有效性

---

不变

⇄ 数据竞争

---

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

☂ 异常安全性

---

如果容器不是空的，函数永远不会抛出异常(no-throw保证)。
否则，它将导致未定义的行为。

🍄  另请参阅

---

list::back	访问最后一个元素(公众成员函数)
list::begin	返回指向列表容器第一个元素的迭代器(公众成员函数)
list::push_front	在开头插入元素(公众成员函数)
list::pop_front	删除第一个元素(公众成员函数)