std::
array::at
公众成员函数 <array>reference at ( size_type n ); const_reference at ( size_type n ) const;
访问元素
返回对数组容器中位置n的元素的引用。
函数自动检查n是否在容器中有效元素的范围内，如果n不在范围内(即n大于或等于其大小)， 则抛出out_of_range异常。这与不检查边界的成员operator[]不一样。
☲ 参数
n
注意，第一个元素的位置是0，而不是1。
如果该值大于或等于数组大小，则抛出out_of_range类型的异常。
成员类型size_type是unsigned整型size_t的别名。
☉ 返回值
数组中指定位置的元素。
如果数组对象是const限定的，则函数返回一个const_reference。否则，它返回一个reference。
成员类型reference和const_reference是对数组元素的引用类型(参见数组成员类型)。
☣ 示例
// 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;
}
|
输出:
myarray contains: 1 2 3 4 5 6 7 8 9 10
myarray contains: 1 2 3 4 5 6 7 8 9 10
✥ 复杂度
稳定
☣ 迭代器的有效性
没有改变
⇄ 数据竞争
返回的引用可用于访问或修改元素。同时访问或修改不同的元素是安全的。
☂ 异常安全性
强保证:如果抛出异常，容器中没有任何变化。 如果n是越界的，它抛出out_of_range。
🍄 另请参阅
| array::operator[] | 访问元素(公众成员函数) |
| array::front | 访问首元素(公众成员函数) |
| array::back | 访问最后一个元素(公众成员函数) |