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

履歴 編集

function
<list>

# std::list::push_back

    void push_back(const T& x);           // (1) C++03
    constexpr void push_back(const T& x); // (1) C++26

    void push_back(T&& x);           // (2) C++11
    constexpr void push_back(T&& x); // (2) C++26

## 概要

新たな要素を末尾に追加する。

## 戻り値

なし

## 計算量

定数時間

## 例

### 基本的な使い方 (C++11)

    #include <iostream>
    #include <list>
    #include <string>
    #include <algorithm>

    int main()
    {
      std::list<std::string> ls;

      // const&バージョン
      std::string s = "hello";
      ls.push_back(s);

      // &&バージョン
      ls.push_back(std::string("world"));

      for (const std::string& x : ls) {
        std::cout << x << std::endl;
      };
    }

#### 出力

    hello
    world

### イテレート中に要素を追加する (C++03)

    #include <iostream>
    #include <list>

    int main()
    {
      std::list<int> ls;
      ls.push_back(3);

      // リストが空になるまで処理をし続ける
      while (!ls.empty()) {
        int x = ls.front();
        ls.pop_front();

        std::cout << x << std::endl;

        // イテレート中にさらに要素が追加される可能性がある。
        //   これはたとえば、イベントキューの実装として使われる。
        //   イベントハンドラ (コールバック関数) のなかでさらにイベントが登録される、
        //   というような状況で、イテレート中に要素追加することが必要になる。
        //
        // ただし、範囲for文のなかでこのようなことをしてはならない (ここではwhile文を使用している)。
        // 範囲for文では終端イテレータは最初に一度のみ取得されるため、イテレート中に
        // 要素が増えても終端イテレータは変わらず、未定義動作になる可能性がある
        if (x > 0) {
          ls.push_back(x - 1);
        }
        else {
          // 要素が追加されなくなったら終了
        }
      }
    }

#### 出力

    3
    2
    1
    0

## 参照

- P3372R3 constexpr containers and adaptors