std::future
Определён в заголовочном файле <future> | ||
|---|---|---|
template< class T > class future; | (1) | (начиная с C++11) |
template< class T > class future<T&>; | (2) | (начиная с C++11) |
template<> class future<void>; | (3) | (начиная с C++11) |
Шаблон класса std::future предоставляет механизм доступа к результату асинхронных операций:
- Асинхронная операция (выполняемая с помощью
std::async,std::packaged_taskилиstd::promise) может предоставить объектstd::futureсоздателю этой асинхронной операции. - Затем создатель асинхронной операции может использовать различные методы для проверки, ожидания или извлечения значения из
std::future. Эти методы могут блокировать выполнение, если асинхронная операция ещё не предоставила значение. - Когда асинхронная операция будет готова отправить результат создателю, она может сделать это, изменив общее состояние (например,
std::promise::set_value), связанное сstd::futureсоздателя.
Обратите внимание, что std::future — это уникальная ссылка на результат в общем состоянии, то есть результат не является общим для других объектов асинхронного возврата. Для неуникального доступа к результату используйте std::shared_future.
Функции-члены
| создаёт объект future (открытая функция-член) |
|
| уничтожает объект future (открытая функция-член) |
|
| перемещает объект future (открытая функция-член) |
|
передаёт общее состояние из *this объекту shared_future и возвращает его (открытая функция-член) |
|
Получение результата |
|
| возвращает результат (открытая функция-член) |
|
Состояние |
|
| проверяет, имеет ли future общее состояние (открытая функция-член) |
|
| ожидает появления результата (открытая функция-член) |
|
| ожидает результата и возвращает управление, если он не стал доступен в течение указанного времени ожидания (открытая функция-член) |
|
| ожидает результата и возвращает управление, если он не стал доступен до указанного момента времени (открытая функция-член) |
|
Примеры
#include <future>
#include <iostream>
#include <thread>
int main()
{
// future from a packaged_task
std::packaged_task<int()> task([]{ return 7; }); // wrap the function
std::future<int> f1 = task.get_future(); // get a future
std::thread t(std::move(task)); // launch on a thread
// future from an async()
std::future<int> f2 = std::async(std::launch::async, []{ return 8; });
// future from a promise
std::promise<int> p;
std::future<int> f3 = p.get_future();
std::thread([&p]{ p.set_value_at_thread_exit(9); }).detach();
std::cout << "Waiting..." << std::flush;
f1.wait();
f2.wait();
f3.wait();
std::cout << "Done!\nResults are: "
<< f1.get() << ' ' << f2.get() << ' ' << f3.get() << '\n';
t.join();
}
Вывод:
Waiting...Done! Results are: 7 8 9
Пример с исключениями
#include <future>
#include <iostream>
#include <thread>
int main()
{
std::promise<int> p;
std::future<int> f = p.get_future();
std::thread t([&p]
{
try
{
// code that may throw
throw std::runtime_error("Example");
}
catch (...)
{
try
{
// store anything thrown in the promise
p.set_exception(std::current_exception());
}
catch (...) {} // set_exception() may throw too
}
});
try
{
std::cout << f.get();
}
catch (const std::exception& e)
{
std::cout << "Exception from the thread: " << e.what() << '\n';
}
t.join();
}
Вывод:
Exception from the thread: Example
См. также
|
(C++11) | асинхронно выполняет функцию (возможно, в новом потоке) и возвращает std::future, в котором будет храниться результат (шаблон функции) |
|
(C++11) | ожидает значение (на которое могут ссылаться другие объекты future), установленное асинхронно (шаблон класса) |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/thread/future
