最終更新日時(UTC): 2026年02月17日 14時22分33秒
Akira Takahashi が更新

履歴 編集

function
<stack>

# std::stack::top

    reference top();           // (1) C++03
    constexpr reference top(); // (1) C++26

    const_reference top() const;           // (2) C++03
    constexpr const_reference top() const; // (2) C++26

## 概要

`stack` の次の要素への参照を返す。

これは一番最後に `stack` に挿入された要素で、`pop()` メンバ関数で削除される要素である。内部のコンテナの `back()` メンバ関数を呼ぶ。

## 効果

    return c.back();

## 戻り値

`stack` の最後の要素への参照。

## 例

    #include <iostream>
    #include <stack>

    int main()
    {
      std::stack<int> st;

      // 要素の追加
      st.push(1);
      st.push(2);
      st.push(3);

      // 末尾要素を表示
      std::cout << st.top();
    }

### 出力

    3

## 実装例

    reference top() { return c.back(); }
    const_reference top() const { return c.back(); }

## 関連項目

名前 | 説明
--- | ---
`push` | 要素の追加
`pop` | 要素の削除

## 参照

- P3372R3 constexpr containers and adaptors