Scroll to navigation

std::atomic_flag::notify_one(3) C++ Standard Libary std::atomic_flag::notify_one(3)

NAME

std::atomic_flag::notify_one - std::atomic_flag::notify_one

Synopsis


void notify_one() noexcept; (since C++20)
void notify_one() volatile noexcept;


Performs atomic notifying operations.


If there is a thread blocked in atomic waiting operation (i.e. wait()) on *this,
then unblocks at least one such thread; otherwise does nothing.

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


wait blocks the thread until notified and the atomic value
(C++20) changes
(public member function)
atomic_flag_wait
atomic_flag_wait_explicit blocks the thread until notified and the flag changes
(C++20) (function)
(C++20)
atomic_flag_notify_one notifies a thread blocked in atomic_flag_wait
(C++20) (function)

2022.07.31 http://cppreference.com