Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::promise — przekazywanie wartości lub wyjątku

std::promise<T> zapisuje pojedynczy wynik we współdzielonym stanie odczytywanym przez std::future<T>. Wynikiem może być wartość albo wyjątek; sam obiekt promise nie uruchamia obliczeń ani wątku.

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

Składnia

#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 nagłówka <future> jest stroną zapisującą wynik, a std::future<T> — stroną odbierającą. std::promise::get_future() zwraca obiekt powiązany z tym samym współdzielonym stanem i można je wywołać tylko raz dla danego stanu. Obiekt promise można przenosić, ale nie kopiować; sam nie uruchamia wątku.

std::promise::set_value zapisuje wartość i oznacza stan jako gotowy. Dla std::promise<T&> zapisuje referencję, a dla std::promise<void> wywołanie set_value() sygnalizuje zakończenie bez wartości. Alternatywnie std::promise::set_exception zapisuje niepusty std::exception_ptr, na przykład z std::current_exception() wewnątrz catch. future.get() czeka na gotowość i odbiera wartość albo ponownie zgłasza zapisany wyjątek. Zapis wyniku synchronizuje się z pomyślnym zakończeniem oczekiwania na ten stan.

Wynik można skutecznie ustawić tylko raz: kolejna próba zgłasza std::future_error z std::future_errc::promise_already_satisfied. Ponowne get_future() zgłasza std::future_errc::future_already_retrieved; brak stanu, na przykład po przeniesieniu, jest warunkiem błędu std::future_errc::no_state. Zniszczenie promise z niegotowym stanem zapisuje std::future_error z std::future_errc::broken_promise i odblokowuje odbiorcę.

Przykłady

#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';
    }
}

Wynik

42
calculation failed

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła