Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::promise — předání hodnoty nebo výjimky

std::promise<T> ukládá jediný výsledek do sdíleného stavu, který se čte prostřednictvím std::future<T>. Výsledkem může být hodnota nebo výjimka; samotný objekt promise nespouští výpočet ani vlákno.

Verze: C++23; repository compiler flag, production runtime not attested

Syntaxe

#include <future>
std::promise<T> p;
std::future<T> f = p.get_future();
p.set_value(value); // success
// Alternatively: p.set_exception(exception_ptr);

std::promise<T> z hlavičky <future> je strana zapisující výsledek, zatímco std::future<T> je strana, která jej přijímá. std::promise::get_future() vrací objekt spojený se stejným sdíleným stavem a pro daný stav jej lze zavolat pouze jednou. Promise lze přesouvat, ale nelze kopírovat; samo o sobě nespouští vlákno.

std::promise::set_value uloží hodnotu a označí stav jako připravený. U std::promise<T&> uloží referenci; u std::promise<void> volání set_value() signalizuje dokončení bez hodnoty. Alternativně std::promise::set_exception uloží nenulový std::exception_ptr, například získaný pomocí std::current_exception() uvnitř bloku catch. future.get() čeká, až bude stav připraven, a získá hodnotu, nebo znovu vyvolá uloženou výjimku. Uložení výsledku se synchronizuje s úspěšným návratem z čekání na tento stav.

Výsledek lze úspěšně nastavit pouze jednou: další pokus vyvolá std::future_error s std::future_errc::promise_already_satisfied. Opakované volání get_future() oznámí std::future_errc::future_already_retrieved; chybějící stav, například po přesunutí, je chybový stav std::future_errc::no_state. Při zničení promise s nepřipraveným stavem se uloží std::future_error s std::future_errc::broken_promise a čekající příjemce se odblokuje.

Příklady

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

int main() {
    std::promise<int> success;
    auto value = success.get_future();
    success.set_value(42);
    std::cout << value.get() << '\n';

    std::promise<int> failure;
    auto error = failure.get_future();
    try {
        throw std::runtime_error("calculation failed");
    } catch (...) {
        failure.set_exception(std::current_exception());
    }

    try {
        std::cout << error.get() << '\n';
    } catch (const std::runtime_error& e) {
        std::cout << e.what() << '\n';
    }
}

Výsledek

42
calculation failed

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje