Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori