Namespaces
Variants

std::promise<R>:: set_exception_at_thread_exit

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
void set_exception_at_thread_exit ( std:: exception_ptr p ) ;
(начиная с C++11)

Сохраняет указатель на исключение p в общее состояние без немедленного перевода состояния в готовность. Состояние переводится в готовность при завершении текущего потока, после уничтожения всех переменных с продолжительностью хранения в потоке.

Операция ведёт себя так, как если бы set_value , set_exception , set_value_at_thread_exit и set_exception_at_thread_exit захватывали единый мьютекс, связанный с объектом promise, при обновлении объекта promise.

Исключение генерируется, если отсутствует общее состояние или общее состояние уже содержит значение или исключение.

Вызовы этой функции не создают состояний гонки данных с вызовами get_future (следовательно, они не требуют синхронизации друг с другом).

Содержание

Параметры

p - указатель на исключение для сохранения. Поведение не определено, если p является nullptr

Возвращаемое значение

(нет)

Исключения

std::future_error при следующих условиях:

  • * this не имеет общего состояния. Код ошибки установлен в no_state .
  • В общем состоянии уже сохранено значение или исключение. Код ошибки установлен в promise_already_satisfied .

Пример

Этот раздел не завершён
Причина: отсутствует пример

Смотрите также

устанавливает результат, указывающий на исключение
(публичная функция-член)