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.