std::atomic_notify_one
|
Defined in header
<atomic> |
||
| (since C++20) | ||
|
template< class T >
void atomic_notify_one( std::atomic<T>* object ); |
||
|
template< class T >
void atomic_notify_one( volatile std::atomic<T>* object ); |
||
Performs atomic notifying operations.
If there is a thread blocked in atomic waiting operation (i.e. std::atomic_wait(), std::atomic_wait_explicit(), or std::atomic::wait()) on *object, then unblocks at least one such thread; otherwise does nothing.
Equivalent to object->notify_one().
Parameters
| object | - | pointer to the atomic object to notify |
Return value
(none)
Notes
This form of change-detection is often more efficient than simple polling or pure spinlocks.
Example
| This section is incomplete Reason: no example |
See also
|
(C++20)
|
notifies at least one thread waiting on the atomic object (public member function of std::atomic<T>) |
|
(C++20)
|
notifies all threads blocked waiting on the atomic object (public member function of std::atomic<T>) |
|
(C++20)
|
notifies all threads blocked in atomic_wait (function template) |
|
(C++20)(C++20)
|
blocks the thread until notified and the atomic value changes (function template) |