Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

std::promise — odovzdanie hodnoty alebo výnimky

std::promise<T> ukladá jediný výsledok do zdieľaného stavu, ktorý sa číta prostredníctvom std::future<T>. Výsledkom môže byť hodnota alebo výnimka; samotný objekt promise nespúšťa výpočet ani vlákno.

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

Syntax

#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úca výsledok, zatiaľ čo std::future<T> je strana, ktorá ho prijíma. std::promise::get_future() vráti objekt spojený s tým istým zdieľaným stavom a pre daný stav ho možno zavolať iba raz. Promise možno presúvať, ale nemožno kopírovať; samo osebe nespúšťa vlákno.

std::promise::set_value uloží hodnotu a označí stav ako pripravený. Pri std::promise<T&> uloží referenciu; pri std::promise<void> volanie set_value() signalizuje dokončenie bez hodnoty. Alternatívne std::promise::set_exception uloží nenulový std::exception_ptr, napríklad získaný pomocou std::current_exception() v bloku catch. future.get() čaká, kým bude stav pripravený, a získa hodnotu alebo znova vyvolá uloženú výnimku. Uloženie výsledku sa synchronizuje s úspešným návratom z čakania na tento stav.

Výsledok možno úspešne nastaviť iba raz: ďalší pokus vyvolá std::future_error s std::future_errc::promise_already_satisfied. Opätovné volanie get_future() oznámi std::future_errc::future_already_retrieved; chýbajúci stav, napríklad po presunutí, je chybový stav std::future_errc::no_state. Pri zničení promise s nepripraveným stavom sa uloží std::future_error s std::future_errc::broken_promise a čakajúci prijímateľ sa odblokuje.

Prí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ýsledok

42
calculation failed

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje