public member function
<list>

std::list::begin

      iterator begin();const_iterator begin() const;
      iterator begin() noexcept;const_iterator begin() const noexcept;
返回到开头的迭代器
返回一个指向 list 容器中第一个元素的迭代器。

请注意,与返回第一个元素引用的成员函数 list::front 不同,此函数返回一个指向它的 双向迭代器

如果容器 为空,则不应解引用返回的迭代器值。

参数



返回值

序列容器的开头迭代器。

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

成员类型iteratorconst_iterator双向迭代器 类型(分别指向一个元素和一个 const 元素)。

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
// list::begin
#include <iostream>
#include <list>

int main ()
{
  int myints[] = {75,23,65,42,13};
  std::list<int> mylist (myints,myints+5);

  std::cout << "mylist contains:";
  for (std::list<int>::iterator it=mylist.begin(); it != mylist.end(); ++it)
    std::cout << ' ' << *it;

  std::cout << '\n';

  return 0;
}

输出
mylist contains: 75 23 65 42 13


复杂度

常量。

迭代器有效性

没有变化。

数据竞争

访问容器(const 和非 const 版本都不会修改容器)。
调用该函数不访问任何包含的元素,但返回的迭代器可用于访问或修改元素。并发访问或修改不同元素是安全的。

异常安全

无异常保证:此成员函数从不抛出异常。
还可以保证返回的迭代器的复制构造或赋值永远不会引发异常。

另见