std::
array::end
公众成员函数 <array>iterator end() noexcept; const_iterator end() const noexcept;
返回到结束元素的下一个元素的迭代器
返回指向数组容器末尾元素的下一个元素的迭代器。
末尾元素的下一个元素是数组中最后一个元素后面的理论元素，它不指向任何元素，因此不能对它解引用。
由于标准库函数所使用的范围不包括其结束迭代器所指向的元素， 因此该函数通常与array::begin组合使用，以指定包含容器中所有元素的范围。
在零大小的数组中，该函数返回与array::begin相同的结果。
☲ 参数
无
☉ 返回值
指向序列末尾元素的下一个元素的迭代器。
如果数组对象是const限定的，则该函数返回常量迭代器对象。否则，它将返回一个迭代器。
成员类型iterator和const_iterator是随机访问迭代器类型(分别指向一个元素和一个const元素)。
☣ 示例
// array::end example
#include <iostream>
#include <array>
int main ()
{
std::array<int,5> myarray = { 5, 19, 77, 34, 99 };
std::cout << "myarray contains:";
for ( auto it = myarray.begin(); it != myarray.end(); ++it )
std::cout << ' ' << *it;
std::cout << '\n';
return 0;
}
|
输出:
myarray contains: 5 19 77 34 99
myarray contains: 5 19 77 34 99
✥ 复杂度
稳定
☣ 迭代器的有效性
没有改变
⇄ 数据竞争
该调用不访问所包含的元素，但返回的迭代器可用于访问或修改元素。同时访问或修改不同的元素是安全的。
☂ 异常安全性
No-throw保证:这个成员函数从不抛出异常。
返回迭代器的复制构造或赋值也保证不会引发抛出。
🍄 另请参阅
| array::cend | 返回一个指向数组末尾元素的常量迭代器 (公众成员函数) |
| array::back | 访问最后一个元素(公众成员函数) |
| array::begin | 返回一个指向数组开头的迭代器 (公众成员函数) |
| array::rbegin | 返回指向数组最后一个元素的反向迭代器 (公众成员函数) |
| array::rend | 返回指向数组开始元素的反向迭代器 (公众成员函数) |