Namespaces
Variants

std::shared_future<T>:: get

From cppreference.net
Concurrency support library
Threads
(C++11)
(C++20)
this_thread namespace
(C++11)
(C++11)
Cooperative cancellation
Mutual exclusion
Generic lock management
Condition variables
(C++11)
Semaphores
Latches and Barriers
(C++20)
(C++20)
Futures
(C++11)
(C++11)
(C++11)
Safe reclamation
Hazard pointers
Atomic types
(C++11)
(C++20)
Initialization of atomic types
(C++11) (deprecated in C++20)
(C++11) (deprecated in C++20)
Memory ordering
(C++11) (deprecated in C++26)
Free functions for atomic operations
Free functions for atomic flags
Haupttemplate
const T & get ( ) const ;
(1) (seit C++11)
std:: shared_future < T & > Spezialisierungen
T & get ( ) const ;
(2) (seit C++11)
std:: shared_future < void > Spezialisierung
void get ( ) const ;
(3) (seit C++11)

Die get Memberfunktion wartet (durch Aufruf von wait() ), bis der gemeinsame Zustand bereit ist, und ruft dann den im gemeinsamen Zustand gespeicherten Wert ab (falls vorhanden).

Wenn valid() vor dem Aufruf dieser Funktion false ist, ist das Verhalten undefiniert.

Inhaltsverzeichnis

Rückgabewert

1) Eine konstante Referenz auf den im gemeinsamen Zustand gespeicherten Wert. Das Verhalten beim Zugriff auf den Wert über diese Referenz nach der Zerstörung des gemeinsamen Zustands ist undefiniert.
2) Die im gemeinsamen Zustand als Wert gespeicherte Referenz.
3) (keine)

Ausnahmen

Wenn eine Ausnahme im gemeinsam genutzten Zustand gespeichert wurde, auf den die Future verweist (z.B. durch einen Aufruf von std::promise::set_exception() ), dann wird diese Ausnahme geworfen.

Hinweise

Der C++-Standard empfiehlt Implementierungen, den Fall zu erkennen, wenn valid() vor dem Aufruf false ist und ein std::future_error mit einem Fehlerzustand von std::future_errc::no_state zu werfen.

Beispiel

Siehe auch

prüft, ob das Future einen gemeinsamen Zustand besitzt
(öffentliche Elementfunktion)