Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C++

std::promise — posredovanje vrednosti ali izjeme

std::promise<T> shrani en rezultat v skupno stanje, ki se bere prek std::future<T>. Rezultat je lahko vrednost ali izjema; objekt promise sam ne zažene izračuna ali niti.

Različica: C++23; repository compiler flag, production runtime not attested

Sintaksa

#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> iz <future> je stran, ki zapisuje rezultat, medtem ko je std::future<T> stran, ki ga prejme. std::promise::get_future() vrne objekt, povezan z istim skupnim stanjem, in ga je za to stanje mogoče poklicati samo enkrat. Promise je mogoče premakniti, ni pa ga mogoče kopirati; samo po sebi ne zažene niti.

std::promise::set_value shrani vrednost in stanje označi kot pripravljeno. Pri std::promise<T&> shrani referenco; pri std::promise<void> klic set_value() označi dokončanje brez vrednosti. Druga možnost je, da std::promise::set_exception shrani neničelni std::exception_ptr, na primer pridobljen z std::current_exception() znotraj bloka catch. future.get() počaka, da je stanje pripravljeno, in pridobi vrednost ali znova sproži shranjeno izjemo. Shranjevanje rezultata se sinhronizira z uspešno vrnitvijo čakanja na to stanje.

Rezultat je mogoče uspešno nastaviti samo enkrat: naslednji poskus sproži std::future_error z std::future_errc::promise_already_satisfied. Ponovni klic get_future() sporoči std::future_errc::future_already_retrieved; odsotnost stanja, na primer po premiku, je napaka std::future_errc::no_state. Če se promise uniči, ko stanje še ni pripravljeno, shrani std::future_error z std::future_errc::broken_promise in odblokira prejemnika.

Primeri

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

Rezultat

42
calculation failed

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri