public member function
<array>

std::array::end

      iterator end() noexcept;const_iterator end() const noexcept;
返回指向末尾的迭代器
返回指向 array 容器中“尾後”元素的迭代器。

“尾後”元素是理論上存在於 array 中最後一個元素之後的元素。它不指向任何元素,因此不應被解引用。

由於標準庫函式使用的範圍不包含其結束迭代器指向的元素,因此此函式通常與 array::begin 結合使用,以指定包含容器中所有元素的範圍。

對於零大小的陣列,此函式返回的值與 array::begin 相同。

引數



返回值

指向序列末尾之後元素的迭代器。

如果 array 物件是 const 限定的,則函式返回一個const_iterator。否則,它返回一個iterator.

成員型別iteratorconst_iterator隨機訪問迭代器 型別(分別指向一個元素和指向一個 const 元素)。

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
// 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


複雜度

常量。

迭代器有效性

沒有變化。

資料競爭

呼叫該函式不訪問任何包含的元素,但返回的迭代器可用於訪問或修改元素。併發訪問或修改不同元素是安全的。

異常安全

無異常保證:此成員函式從不丟擲異常。
還可以保證返回的迭代器的複製構造或賦值永遠不會引發異常。

另見