std::future
Von cppreference.com
| Definiert im Header <future> |
||
| template< class T > class future; |
(1) | (seit C++11) |
| template< class T > class future<T&>; |
(2) | (seit C++11) |
| template<> class future<void>; |
(3) | (seit C++11) |
Die Klassenschablone std::future bietet einen Mechanismus zum Zugriff auf das Ergebnis asynchroner Operationen.
- Eine asynchrone Operation (erstellt über std::async, std::packaged_task oder std::promise) kann dem Ersteller dieser asynchronen Operation ein
std::future-Objekt bereitstellen.
- Der Ersteller der asynchronen Operation kann dann eine Vielzahl von Methoden verwenden, um das
std::futureabzufragen, auf dessen Ergebnis zu warten oder einen Wert daraus zu extrahieren. Diese Methoden können blockieren, wenn die asynchrone Operation noch keinen Wert bereitgestellt hat.
- Wenn die asynchrone Operation bereit ist, ein Ergebnis an den Ersteller zu senden, kann sie dies tun, indem sie den *gemeinsamen Zustand* modifiziert (z. B. std::promise::set_value), der mit dem
std::futuredes Erstellers verknüpft ist.
Beachten Sie, dass std::future einen gemeinsamen Zustand referenziert, der nicht mit anderen asynchronen Rückgabeobjekten geteilt wird (im Gegensatz zu std::shared_future).
Inhalt |
[bearbeiten] Memberfunktionen
| konstruiert das Future-Objekt (public member function) | |
| zerstört das Future-Objekt (public member function) | |
| verschiebt das Future-Objekt (public member function) | |
| überträgt den gemeinsamen Zustand von *this auf ein shared_future und gibt dieses zurück (public member function) | |
Ergebnis abrufen | |
| gibt das Ergebnis zurück (public member function) | |
Zustand | |
| prüft, ob das Future einen gemeinsamen Zustand hat (public member function) | |
| wartet, bis das Ergebnis verfügbar ist (public member function) | |
| wartet auf das Ergebnis, gibt zurück, wenn es für die angegebene Zeitdauer nicht verfügbar ist (public member function) | |
| wartet auf das Ergebnis, gibt zurück, wenn es nicht verfügbar ist, bis der angegebene Zeitpunkt erreicht ist (public member function) | |
[bearbeiten] Beispiele
Führen Sie diesen Code aus
#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(); }
Ausgabe
Waiting...Done! Results are: 7 8 9
[bearbeiten] Beispiel mit Ausnahmen
Führen Sie diesen Code aus
#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(); }
Ausgabe
Exception from the thread: Example
[bearbeiten] Siehe auch
| (C++11) |
führt eine Funktion asynchron aus (potenziell in einem neuen Thread) und gibt ein std::future zurück, das das Ergebnis enthalten wird (Funktionsvorlage) |
| (C++11) |
wartet auf einen Wert (möglicherweise von anderen Futures referenziert), der asynchron gesetzt wird (Klassenvorlage) |
