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 ( ) ;
(depuis C++11)

Retourne un objet futur associé au même état partagé que * this .

Une exception est levée si * this n'a pas d'état partagé ou si get_future a déjà été appelé. Pour obtenir plusieurs extrémités "pop" du canal de communication promise-future, utilisez std::future::share .

Les appels à cette fonction n'introduisent pas de courses de données avec les appels à set_value , set_exception , set_value_at_thread_exit , ou set_exception_at_thread_exit (par conséquent, ils n'ont pas besoin de se synchroniser entre eux).

Paramètres

(aucun)

Valeur de retour

Un futur faisant référence à l'état partagé de * this .

Exceptions

std::future_error dans les conditions suivantes :

  • * this n'a pas d'état partagé. Le code d'erreur est défini sur no_state .
  • get_future() a déjà été appelé sur une promesse ayant le même état partagé que * this . Le code d'erreur est défini à future_already_retrieved .