std::promise, std::future, std::shared_future

スレッドをまたいで値や例外を受け渡すには、std::promise および std::future または std::shared_future を使用します。

これらのクラスについて使用例などを記載したいと思います。

 

 

 

1. promise, future を使ってみる

[概要]

スレッド間で非同期に値や例外を受け渡す方法として、std::promise および std::future というクラスが提供されています。

あるスレッドで std::promise クラスのオブジェクトに値や例外を設定すると、それを別のスレッドで std::future クラスのオブジェクトを通してスレッドセーフに受け取ることができます。

子のサンプルでは、作成したスレッド worker 上で架空の計算を行ったものとして計算結果 42 を std::promise オブジェクト p へ設定します。もしくは計算中に例外を発生した場合、発生した例外を std::promise オブジェクト p へ設定します。メインスレッドはその計算結果が終わるのを待って計算結果を受け取っています。もしくは計算中に発生した例外を受け取ります。

これらのクラスは、マルチスレッドだけではなくシングルスレッドで非同期処理を行う場合にも利用できます。

 

[環境]

コンパイラ : g++ (Ubuntu 13.3.0-6ubuntu2~24.04) 13.3.0
OS : Ubuntu 24.04.2 LTS (WSL)

 

[プログラムソース]

#include <iostream>
#include <thread>
#include <future>
#include <exception>

void worker(std::promise<int> p) {
    try{
        std::this_thread::sleep_for(std::chrono::seconds(10));
        //throw std::runtime_error("Worker thread error"); // 例外を発生させる
        p.set_value(42); // 値をセット
    } catch (...) {
        p.set_exception(std::current_exception()); // 発生した例外をセット
    }
}

int main() {
    std::promise<int> p;
    std::future<int> f = p.get_future();

    // worker関数を別スレッドで実行
    std::thread t(worker, std::move(p));

    try{
        std::cout << "値を待っています..." << std::endl;
        int result = f.get(); // 値がセットされるまで待つ
        std::cout << "受け取った値: " << result << std::endl;
    } catch (std::exception& e) {
        std::cout << "例外が発生しました: " << e.what() << std::endl;
    }

    t.join();
    return 0;
}

 

 

2. std::future::wait_for で非同期操作の完了を確認する

[概要]

前章では別タスクの演算結果をf.get()で取得していました。意図通りの動作ではありますが、せっかく別タスクで計算を行っているのに演算結果の取得待ちになるので別タスクで演算しているかいがありません。別タスクで計算を行っている間にさらに別の作業を行えるようにしたいと思います。

std::future::wait_forという非同期操作の進捗を待つ際に便利なメソッドがあります。これを使用すると、指定した期間中に非同期操作が完了したかどうかを確認できます。

  1. 戻り値:
    • std::future_status::ready: タスクが完了して値が取得可能
    • std::future_status::timeout: 指定した時間内にタスクが完了しなかった
    • std::future_status::deferred: タスクの実行が遅延されている
  2. 時間を指定:
    • wait_for に渡す時間は std::chrono::duration 形式で指定します

 

[環境]

コンパイラ : g++ (Ubuntu 13.3.0-6ubuntu2~24.04) 13.3.0
OS : Ubuntu 24.04.2 LTS (WSL)

 

[プログラムソース]

#include <iostream>
#include <thread>
#include <future>
#include <exception>

void worker(std::promise<int> p) {
    try{
        std::this_thread::sleep_for(std::chrono::seconds(10));
        //throw std::runtime_error("Worker thread error"); // 例外を発生させる
        p.set_value(42); // 値をセット
    } catch (...) {
        p.set_exception(std::current_exception()); // 発生した例外をセット
    }
}

int main() {
    std::promise<int> p;
    std::future<int> f = p.get_future();

    // worker関数を別スレッドで実行
    std::thread t(worker, std::move(p));

    try{
        std::cout << "値を待っています..." << std::endl;
        while(f.wait_for(std::chrono::seconds(1)) != std::future_status::ready) {
            std::cout << "まだ値がセットされていません..." << std::endl;
        }
        // 値がセットされた
        int result = f.get(); // 値を取得
        std::cout << "受け取った値: " << result << std::endl;
    } catch (std::exception& e) {
        std::cout << "例外が発生しました: " << e.what() << std::endl;
    }

    t.join();
    return 0;
}

 

実行結果

値を待っています...
まだ値がセットされていません...
まだ値がセットされていません...
まだ値がセットされていません...
まだ値がセットされていません...
まだ値がセットされていません...
まだ値がセットされていません...
まだ値がセットされていません...
まだ値がセットされていません...
まだ値がセットされていません...
受け取った値: 42

 

 

ライセンス

本ページの情報は、特記無い限り下記 MIT ライセンスで提供されます。

The MIT License (MIT)

  Copyright 2025 Kinoshita Hidetoshi

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

 

 

参考

 


 

変更履歴

2025-05-31 - 新規作成

 

Programming Items トップページ

プライバシーポリシー