public member function
<array>

std::array::front

      reference front();const_reference front() const;
訪問第一個元素
返回對 array 容器中第一個元素的引用。

與返回指向相同元素的迭代器的成員 array::begin 不同,此函式返回一個直接引用。

在空容器上呼叫此函式會導致未定義行為。

引數



返回值

對陣列中第一個元素的引用。

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

成員型別引用const_reference是 array 中元素的引用型別(參見 array 成員型別)。

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
// array::front
#include <iostream>
#include <array>

int main ()
{
  std::array<int,3> myarray = {2, 16, 77};

  std::cout << "front is: " << myarray.front() << std::endl;   // 2
  std::cout << "back is: " << myarray.back() << std::endl;     // 77

  myarray.front() = 100;

  std::cout << "myarray now contains:";
  for ( int& x : myarray ) std::cout << ' ' << x;

  std::cout << '\n';

  return 0;
}

輸出
front is: 2
back is: 77
myarray now contains: 100 16 77


複雜度

常量。

迭代器有效性

沒有變化。

資料競爭

返回的引用可用於訪問或修改元素。併發訪問或修改不同元素是安全的。

異常安全

如果容器不為空,則函式永遠不會丟擲異常(no-throw guarantee)。
否則,將導致未定義行為

另見