|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
void notify_one()constnoexcept; | (constexpr since C++26) | |
Performs atomic notifying operations.
If there is a thread blocked in atomic waiting operation (i.e.wait()) on*ptr, then unblocksat least one such thread; otherwise does nothing.This overload participates in overload resolution only ifstd::is_const_v<T> isfalse.
Contents |
This form of change-detection is often more efficient than simple polling or pure spinlocks.
| This section is incomplete Reason: no example |
The following behavior-changing defect reports were applied retroactively to previously published C++ standards.
| DR | Applied to | Behavior as published | Correct behavior |
|---|---|---|---|
| LWG 3508 (P3323R1) | C++20 | notify_one was meaningless forconst T | constrained to accept only non-constT |
| blocks the thread until notified and the atomic value changes (public member function)[edit] | |
(C++20)(C++20) | blocks the thread until notified and the atomic value changes (function template)[edit] |
(C++20) | notifies a thread blocked in atomic_wait (function template)[edit] |
