deque::begin-c和c++中文资料站

C&C++标准库

std::

deque::begin

公众成员函数 <deque>

C++98:

      iterator begin();
const_iterator begin() const;

返回到开头的迭代器
返回指向deque容器第一个元素的迭代器。

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

如果容器为空，则不能对返回的迭代器值进行解引用。

☲ 参数

none

☉ 返回值

到序列容器开头的迭代器。
如果deque对象是const限定的，则该函数返回const_iterator对象。否则，它将返回一个迭代器。
成员类型iterator和const_iterator是随机访问迭代器类型(分别指向一个元素和一个const元素)。

☣ 示例

// 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版本都不会修改容器)。
该调用不访问所包含的元素，但返回的迭代器可用于访问或修改元素。
同时访问或修改不同的元素是安全的。

☂ 异常安全性

No-throw保证:这个成员函数从不抛出异常。
返回迭代器的复制构造或赋值也保证不会引发抛出。

🍄 另请参阅

deque::front	访问首元素(公众成员函数)
deque::end	返回一个指向双端队列末尾元素的下一个元素的迭代器 (公众成员函数)
deque::rbegin	返回指向双端队列最后一个元素的反向迭代器(公众成员函数)
deque::rend	返回指向双端队列开始元素之前的理论元素的反向迭代器(公众成员函数)