C++ Reference: Standard C++ Library reference: Containers: deque: deque: at

C++官网参考链接：https://cplusplus.com/reference/deque/deque/at/

公有成员函数 
<deque>
std::deque::at
reference at (size_type n);
const_reference at (size_type n) const;
访问元素
返回deque容器对象中位置n的元素的reference。
该函数自动检查n是否在容器中有效元素的边界内，如果不在则抛出out_of_range异常（即，如果n大于或等于它的size）。这与成员operator[]相反，成员operator[]不检查边界。
返回deque容器对象中位置n的元素的reference。
这个成员函数和成员操作符函数operator[]的区别在于，如果请求的位置超出了范围，deque::at会抛出out_of_range异常，从而发出信号。

形参 
n
元素在容器中的位置。
如果该值大于或等于deque的size，则抛出out_of_range类型的异常。
注意，第一个元素的位置为0（而不是1）。
成员类型size_type是无符号整型。

返回值
位于容器中指定位置的元素。
如果deque对象是const限定的，该函数返回一个const_reference。否则，它返回一个reference。
成员类型reference和const_reference是容器元素的reference类型（参见deque成员类型（deque member types））。

用例
// 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;
}
输出：

复杂度 
常量。 

iterator的有效性
没有变化。

数据竞争
容器被访问（const和非const版本都不会修改容器）。
元素n可能被调用者访问或修改。同时访问或修改其他元素是安全的。

异常安全
强保证：如果抛出异常，则容器中不会有任何更改。
如果n超出边界，则抛出out_of_range。