Namespaces
Variants

std::promise<R>:: get_future

From cppreference.net
C++
Concurrency support library
Threads
(C++11)
(C++20)
(C++17) (C++17)
this_thread namespace
(C++11)
(C++11)
Cooperative cancellation
Mutual exclusion
Generic lock management
Condition variables
(C++11)
(C++11)
(C++11)
(C++11)
Semaphores
(C++20) (C++20)
Latches and Barriers
(C++20)
(C++20)
Futures
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
Safe reclamation
Hazard pointers
(C++26)
(C++26)
(C++26)
Atomic types
(C++11)
(C++20)
(C++11)
Initialization of atomic types
(C++11) (deprecated in C++20)
(C++11) (deprecated in C++20)
(C++11)
Memory ordering
(C++11)
(C++11) (deprecated in C++26)
(C++11)
(C++11)
Free functions for atomic operations
(C++11) (C++11)
(C++11) (C++11)
(C++11) (C++11)
(C++11) (C++11) (C++11) (C++11)
(C++11) (C++11)
(C++11) (C++11)
(C++11) (C++11)
(C++11) (C++11)
(C++11) (C++11)
(C++26) (C++26)
(C++26) (C++26)
(C++11)
(C++20) (C++20)
(C++20)
(C++20)
Free functions for atomic flags
(C++11) (C++11)
(C++11) (C++11)
(C++20) (C++20)
(C++20) (C++20)
(C++20)
(C++20)
std::promise
std:: future < R > get_future ( ) ;
(seit C++11)

Gibt ein Future-Objekt zurück, das mit demselben gemeinsamen Zustand assoziiert ist wie * this .

Eine Ausnahme wird ausgelöst, wenn * this keinen gemeinsamen Zustand hat oder get_future bereits aufgerufen wurde. Um mehrere "Pop"-Enden des Promise-Future-Kommunikationskanals zu erhalten, verwenden Sie std::future::share .

Aufrufe dieser Funktion führen nicht zu Datenrennen mit Aufrufen von set_value , set_exception , set_value_at_thread_exit oder set_exception_at_thread_exit (daher müssen sie nicht miteinander synchronisiert werden).

Parameter

(keine)

Rückgabewert

Ein Future, das sich auf den gemeinsamen Zustand von * this bezieht.

Ausnahmen

std::future_error unter den folgenden Bedingungen:

  • * this besitzt keinen gemeinsamen Zustand. Der Fehlercode wird auf no_state gesetzt.
  • get_future() wurde bereits für ein Promise mit demselben gemeinsamen Zustand wie * this aufgerufen. Der Fehlercode ist auf future_already_retrieved gesetzt.