最終更新日時: 2025年07月12日 02時16分44秒 (JST)
Koichi Murase が更新

履歴 編集

function
<future>

# std::packaged_task::operator()(C++11)

    void operator()(ArgTypes... args);

## 概要

タスクの実行し、戻り値を共有状態に格納する。

## 効果

メンバ変数として保持している関数オブジェクト`f`に対して`INVOKE(f, args..., R)`によって関数呼び出しを行い、その戻り値を`future`との共有状態に格納する。関数`f`の内部で例外が送出された場合は、共有状態に送出された例外が格納される。

共有状態が準備完了状態(`future_status::ready`)となる。

## 戻り値

なし

## 例外

この関数は、以下のerror conditionを持つ`future_error` 例外オブジェクトを送出する可能性がある：

- `promise_already_satisfied` ： 格納されたタスクがすでに実行された
- `no_state`： `*this`が共有状態を持っていない(`packaged_task`オブジェクトがムーブされると起こりうる)

## 例

    #include <iostream>
    #include <future>
    #include <stdexcept>

    int plus_task(int a, int b)
    {
      return a + b;
    }

    int except_task()
    {
      throw std::runtime_error("error!");
    }

    int main()
    {
      {
        std::packaged_task<int(int, int)> task(plus_task);
        std::future<int> f = task.get_future();

        // タスクを実行する
        task(2, 3);

        // タスクの結果を取得
        int result = f.get();
        std::cout << result << std::endl;
      }

      // 例外を投げるタスク
      {
        std::packaged_task<int()> task(except_task);
        std::future<int> f = task.get_future();

        // タスクを実行する
        task();

        // タスクの結果を取得
        try {
          f.get();
        }
        catch (std::runtime_error& e) {
          // タスク内で送出された例外を捕捉
          std::cout << e.what() << std::endl;
        }
      }
    }

### 出力

    5
    error!

## バージョン

### 言語

- C++11

### 処理系

- Clang: ??
- GCC: 4.7.0 ✅
- ICC: ??
- Visual C++: 2012 ✅

## 参照