База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C++

std::shared_future — споделен достъп до резултат

std::shared_future позволява на множество потребители да имат достъп до един и същ резултат или изключение. Може да се копира и get() да се извиква многократно; wait() изчаква готовността, а wait_for() я проверява с времево ограничение.

Версия: C++23; repository compiler flag, production runtime not attested

Синтаксис

#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> от <future> е копируем дескриптор към споделено състояние, съдържащо резултат или изключение. Копията сочат към едно и също състояние, а не към копия на резултата. future.share() прехвърля състоянието от std::future<T> към std::shared_future<T>; след това изходният обект има valid() == false.

std::shared_future::get() изчаква резултатът да е готов и връща const T&; за std::shared_future<T&> връща T&, а за std::shared_future<void> не връща стойност. Ако има съхранено изключение, то се хвърля. За разлика от std::future::get(), операцията не изразходва състоянието: разрешени са многократни извиквания. Не използвайте препратка към съхранената стойност след унищожаването на споделеното състояние; специализацията за препратка не удължава живота на посочения обект.

std::shared_future::wait() изчаква готовността, без да извлича резултата или да хвърля съхраненото изключение. std::shared_future::wait_for(duration) връща std::future_status::ready, std::future_status::timeout или std::future_status::deferred. При отложена задача връща deferred, без да я стартира; wait() или get() може да я изпълни. Времевото ограничение не отменя работата и не гарантира строго време за връщане.

Тези три операции изискват valid() == true; нарушаването на условието води до неопределено поведение, а не до гарантирано изключение. В различни нишки използвайте отделни копия на дескриптора. Готовността синхронизира публикуването на резултата, но последващите едновременни промени на данните изискват собствена синхронизация. Примерът умишлено използва една нишка: показва споделеното състояние и повторното четене без зависимост от планирането.

Примери

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

Резултат

timeout: true
ready: true
42 42 42

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници