std::array<T,N>::front

出自cppreference.com

[編輯模板]
 
C++
 
容器庫
 
std::array
 
reference front();
(1) (C++11 起)
(C++17 起為 constexpr)		 
const_reference front() const;
(2) (C++11 起)
(C++14 起為 constexpr)

返回到容器首元素的引用。

如果 empty() 是 true，那麼行為未定義。

(C++26 前)

如果 empty() 是 true，那麼：

  • 如果實現是硬化實現，那麼就會發生契約違背。
  • 如果實現不是硬化實現，那麼行為未定義。
 (C++26 起)

返回值

到首元素的引用。

複雜度

常數。

註解

對於容器 c，表達式 c.front() 等價於 *c.begin()。

示例

下列代碼用 front 顯示 std::array<char, 4> 的首元素：

運行此代碼
#include <cassert>
#include <array>
 
int main()
{
    std::array<char, 4> letters{'a', 'b', 'c', 'd'};
    assert(letters.front() == 'a');
}

參閱

 訪問最後一個元素
(公開成員函數) [編輯]
返回指向末尾的逆向迭代器
(公開成員函數) [編輯]
返回指向起始的迭代器
(公開成員函數) [編輯]
直接訪問底層連續存儲
(公開成員函數) [編輯]