C++官网参考链接:https://cplusplus.com/reference/array/array/at/
公有成员函数
<array>
std::array::at
reference at ( size_type n );
const_reference at ( size_type n ) const;
访问元素
返回array中位置为n的元素的reference。
该函数自动检查n是否在容器中有效元素的边界内,如果不在则抛出out_of_range异常(即,如果n大于或等于其size)。
这与成员operator[]相反,成员operator[]不检查边界。
形参
n
array中元素的位置。
如果该值大于或等于array的size,则抛出out_of_range类型的异常。
注意,第一个元素的位置为0(而不是1)。
成员类型size_type是无符号整型size_t的别名。
返回值
array中指定位置的元素。
如果array对象是const限定的,该函数返回一个const_reference。否则,它返回一个reference。
成员类型reference和const_reference是array元素的reference类型(参见array成员类型(array member types))。
用例
// array::at
#include <iostream>
#include <array>
int main ()
{
std::array<int,10> myarray;
// assign some values:
for (int i=0; i<10; i++) myarray.at(i) = i+1;
// print content:
std::cout << "myarray contains:";
for (int i=0; i<10; i++)
std::cout << ' ' << myarray.at(i);
std::cout << '\n';
return 0;
}
输出:
复杂度
常量。
iterator的有效性
没有变化。
数据竞争
返回的reference可用于访问或修改元素。同时访问或修改不同的元素是安全的。
异常安全
强保证:如果抛出异常,则容器中不会有任何更改。
如果n超出边界,则抛出out_of_range。