KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::promise — een waarde of uitzondering doorgeven

std::promise<T> slaat één resultaat op in een gedeelde toestand die via std::future<T> wordt gelezen. Het resultaat kan een waarde of uitzondering zijn; het promise-object zelf start geen berekening of thread.

Versie: 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> uit <future> is de kant die het resultaat schrijft; std::future<T> is de ontvangende kant. std::promise::get_future() geeft een object terug dat aan dezelfde gedeelde toestand is gekoppeld en kan voor die toestand maar één keer worden aangeroepen. Een promise kan worden verplaatst, maar niet gekopieerd; het start zelf geen thread.

std::promise::set_value slaat een waarde op en maakt de toestand gereed. Voor std::promise<T&> slaat het een verwijzing op; bij std::promise<void> geeft set_value() aan dat de bewerking is voltooid, zonder waarde. Als alternatief slaat std::promise::set_exception een niet-null std::exception_ptr op, bijvoorbeeld verkregen met std::current_exception() binnen een catch-blok. future.get() wacht tot de toestand gereed is en haalt de waarde op of gooit de opgeslagen uitzondering opnieuw. Het opslaan van het resultaat synchroniseert met de geslaagde terugkeer van het wachten op die toestand.

Het resultaat kan maar één keer succesvol worden ingesteld: een volgende poging gooit std::future_error met std::future_errc::promise_already_satisfied. Een volgende aanroep van get_future() meldt std::future_errc::future_already_retrieved; het ontbreken van een toestand, bijvoorbeeld na verplaatsen, is de foutconditie std::future_errc::no_state. Als een promise wordt vernietigd terwijl de toestand nog niet gereed is, slaat het std::future_error met std::future_errc::broken_promise op en wordt de ontvanger gedeblokkeerd.

Voorbeelden

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

Resultaat

42
calculation failed

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen