C++

参考

<deque>

deque

public member function
<deque>

std::deque::begin

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

请注意，与返回第一个元素引用的成员函数 deque::front 不同，此函数返回一个指向它的随机访问迭代器。

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

参数

无

返回值

指向序列容器开头的迭代器。

如果 deque 对象是 const 限定的，则函数返回一个const_iterator。否则，它返回一个iterator.

成员类型iterator和const_iterator是 随机访问迭代器 类型（分别指向一个元素和指向一个 const 元素）。

示例

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

int main ()
{
  std::deque<int> mydeque;

  for (int i=1; i<=5; i++) mydeque.push_back(i);

  std::cout << "mydeque contains:";

  std::deque<int>::iterator it = mydeque.begin();

  while (it != mydeque.end())
    std::cout << ' ' << *it++;

  std::cout << '\n';

  return 0;
}

输出
mydeque contains: 1 2 3 4 5


复杂度

常量。

迭代器有效性

没有变化。

数据竞争

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

异常安全

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

另见

deque::front
访问第一个元素 (公开成员函数)
deque::end
返回指向末尾的迭代器 (公开成员函数)
deque::rbegin
返回指向反向起始位置的反向迭代器 (公开成员函数)
deque::rend
返回指向反向末尾的反向迭代器 (公开成员函数)