std::

deque::at

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

返回对deque容器中位置为n的元素的引用。

函数自动检查n是否在容器中有效元素的范围内，如果不在范围内(即n大于或等于其大小)， 则抛出out_of_range异常。这与不检查边界的成员操作符[]形成了对比。

这个成员函数和成员操作符operator[]的区别在于，如果请求的位置超出范围， deque::at会抛出一个out_of_range异常。

☲  参数

---

n

元素在容器中的位置。
如果这个值大于deque容器的大小，则抛出out_of_range类型的异常。
注意第一个元素的位置是0(不是1)。
成员类型size_type是一个无符号整型。

☉  返回值

---

在容器中指定位置的元素。
如果deque对象是const限定的，则函数返回一个const_reference。否则，它返回一个引用。
成员类型reference和const_reference是对容器元素的引用类型(参见deque成员类型)。

☣  示例

---

// deque::at #include <iostream> #include <deque> int main () { std::deque<unsigned> mydeque (10); // 10 zero-initialized unsigneds // assign some values: for (unsigned i=0; i<mydeque.size(); i++) mydeque.at(i)=i; std::cout << "mydeque contains:"; for (unsigned i=0; i<mydeque.size(); i++) std::cout << ' ' << mydeque.at(i); std::cout << '\n'; return 0; }

✥ 复杂度

---

常量

☣ 迭代器的有效性

---

不变

⇄ 数据竞争

---

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

☂ 异常安全性

---

强保证:如果抛出异常，容器中没有任何变化。
如果n是越界的，它抛出out_of_range。

🍄  另请参阅

---

deque::operator[]	访问元素(公众成员函数)
deque::front	访问首元素 (公众成员函数)
deque::back	访问最后一个元素(公众成员函数)