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

CKTIS / C++

std::shared_future — skupni dostop do rezultata

std::shared_future omogoča več prejemnikom dostop do istega rezultata ali izjeme. Lahko ga kopiramo in večkrat pokličemo get(); wait() čaka na pripravljenost, wait_for() pa jo preveri s časovno omejitvijo.

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

Sintaksa

#include <chrono>
#include <future>
std::shared_future<T> sf = future.share();
const T& value = sf.get(); // primary template
sf.wait();
std::future_status status = sf.wait_for(std::chrono::milliseconds{0});

std::shared_future<T> iz <future> je kopirljiv ročaj do skupnega stanja, ki vsebuje rezultat ali izjemo. Kopije se nanašajo na isto stanje, ne na kopije rezultata. future.share() prenese stanje iz std::future<T> v std::shared_future<T>; izvorni objekt ima nato valid() == false.

std::shared_future::get() počaka, da je rezultat pripravljen, in vrne const T&; za std::shared_future<T&> vrne T&, za std::shared_future<void> pa ne vrne vrednosti. Če je izjema shranjena, jo sproži. V nasprotju z std::future::get() stanja ne porabi, zato so ponovni klici dovoljeni. Sklicevanja na shranjeno vrednost ne smemo uporabljati po uničenju skupnega stanja; referenčna specializacija ne podaljša življenjske dobe referenciranega objekta.

std::shared_future::wait() počaka na pripravljenost, ne da bi pridobil rezultat ali sprožil shranjeno izjemo. std::shared_future::wait_for(duration) vrne std::future_status::ready, std::future_status::timeout ali std::future_status::deferred. Pri odloženi nalogi vrne deferred, ne da bi jo zagnal; izvede jo lahko wait() ali get(). Časovna omejitev ne prekliče dela in ne zagotavlja strogega časa vrnitve.

Te tri operacije zahtevajo valid() == true; kršitev tega pogoja povzroči nedefinirano vedenje, ne pa zajamčene izjeme. V različnih nitih uporabljajte ločene kopije ročaja. Pripravljenost sinhronizira objavo rezultata, poznejše sočasne spremembe podatkov pa potrebujejo lastno sinhronizacijo. Primer namenoma uporablja eno nit: prikaže skupno stanje in ponavljajoče se branje brez odvisnosti od razporejanja.

Primeri

#include <chrono>
#include <future>
#include <iostream>

int main() {
    std::promise<int> producer;
    std::shared_future<int> first = producer.get_future().share();
    auto second = first;

    const auto before = first.wait_for(std::chrono::milliseconds{0});
    producer.set_value(42);
    second.wait();
    const auto after = second.wait_for(std::chrono::milliseconds{0});

    std::cout << std::boolalpha;
    std::cout << "timeout: " << (before == std::future_status::timeout) << '\n';
    std::cout << "ready: " << (after == std::future_status::ready) << '\n';
    std::cout << first.get() << ' ' << second.get() << ' ' << first.get() << '\n';
}

Rezultat

timeout: true
ready: true
42 42 42

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

Viri