База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C++

std::promise — предаване на стойност или изключение

std::promise<T> съхранява един резултат в споделено състояние, което се чете чрез std::future<T>. Резултатът може да бъде стойност или изключение; самият обект promise не стартира изчисление или нишка.

Версия: C++23; repository compiler flag, production runtime not attested

Синтаксис

#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> от <future> е страната, която записва резултата, а std::future<T> е страната, която го получава. std::promise::get_future() връща обект, свързан със същото споделено състояние, и може да бъде извикан само веднъж за това състояние. Promise може да бъде преместван, но не и копиран; самият той не стартира нишка.

std::promise::set_value съхранява стойност и маркира състоянието като готово. При std::promise<T&> съхранява препратка; при std::promise<void> извикването на set_value() сигнализира за завършване без стойност. Като алтернатива std::promise::set_exception съхранява ненулев std::exception_ptr, например получен чрез std::current_exception() в блок catch. future.get() изчаква състоянието да стане готово и получава стойността или повторно хвърля съхраненото изключение. Съхраняването на резултата се синхронизира с успешното връщане от изчакването на това състояние.

Резултатът може да бъде зададен успешно само веднъж: следващ опит хвърля std::future_error с std::future_errc::promise_already_satisfied. Повторно извикване на get_future() сигнализира std::future_errc::future_already_retrieved; липсата на състояние, например след преместване, е условието за грешка std::future_errc::no_state. Унищожаването на promise с все още неготово състояние съхранява std::future_error с std::future_errc::broken_promise и освобождава чакащия получател.

Примери

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

Резултат

42
calculation failed

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници