CKTIS / C++
std::shared_future — zajednički pristup rezultatu
std::shared_future omogućuje većem broju korisnika pristup istom rezultatu ili iznimci. Može se kopirati i pozivati get() više puta; wait() čeka spremnost, a wait_for() provjerava spremnost uz vremensko ograničenje.
Verzija: 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> kopirljiva je ručka na zajedničko stanje koje sadržava rezultat ili iznimku. Kopije upućuju na isto stanje, a ne na kopije rezultata. future.share() prenosi stanje iz std::future<T> u std::shared_future<T>; izvorni objekt nakon toga ima valid() == false.
std::shared_future::get() čeka da rezultat bude spreman i vraća const T&; za std::shared_future<T&> vraća T&, a za std::shared_future<void> ne vraća vrijednost. Ako postoji pohranjena iznimka, izbacuje je. Za razliku od std::future::get(), ne troši stanje: ponovljeni pozivi dopušteni su. Referenca na pohranjenu vrijednost ne smije se koristiti nakon uništenja zajedničkog stanja; referentna specijalizacija ne produljuje životni vijek referenciranog objekta.
std::shared_future::wait() čeka spremnost bez dohvaćanja rezultata ili izbacivanja pohranjene iznimke. std::shared_future::wait_for(duration) vraća std::future_status::ready, std::future_status::timeout ili std::future_status::deferred. Za odgođeni zadatak vraća deferred bez pokretanja; wait() ili get() može ga izvršiti. Vremensko ograničenje ne otkazuje rad niti jamči strogo vrijeme povratka.
Ove tri operacije zahtijevaju valid() == true; kršenje tog uvjeta uzrokuje nedefinirano ponašanje, a ne zajamčenu iznimku. U različitim nitima koristite zasebne kopije ručke. Spremnost sinkronizira objavu rezultata, no kasnije istodobne izmjene podataka zahtijevaju vlastitu sinkronizaciju. Primjer namjerno koristi jednu nit: prikazuje zajedničko stanje i ponovljena čitanja bez ovisnosti o raspoređivanju.
Primjeri
#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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.