std::condition_variable_any::notify_one
来自 cppreference.com
< cpp | thread | condition variable any
| void notify_one() noexcept; |
(自 C++11 起) | |
如果任何线程正在等待 *this，调用 notify_one 将解除阻塞其中一个等待线程。
内容 |
[编辑] 参数
(无)
[编辑] 返回值
(无)
[编辑] 备注
notify_one()/notify_all() 和 wait()/wait_for()/wait_until() 的三个原子部分（解锁 + 等待、唤醒和锁定）的影响在单个总顺序中发生，可以将其视为原子变量的修改顺序：顺序特定于此单个条件变量。这使得 notify_one() 无法例如延迟并解除阻塞在调用 notify_one() 之后才开始等待的线程。
通知线程不需要持有与等待线程(s)所持有的相同互斥锁；实际上，这样做是一种弊端，因为通知的线程会立即再次阻塞，等待通知线程释放锁。但是，某些实现（特别是许多 pthreads 实现）会识别这种情况，并通过在 notify 调用中将等待线程从条件变量的队列直接转移到互斥锁的队列，而不会唤醒它，从而避免这种“赶快等待”场景。
在锁定下进行通知可能仍然是必要的，尤其是在需要精确事件调度时，例如，如果等待线程在满足条件时退出程序，从而导致通知线程的条件变量被销毁。在互斥锁解锁后但通知之前发生的虚假唤醒会导致在销毁的对象上调用通知。
[编辑] 示例
运行此代码
#include <chrono> #include <condition_variable> #include <iostream> #include <thread> using namespace std::chrono_literals; std::condition_variable_any cv; std::mutex cv_m; int i = 0; bool done = false; void waits() { std::unique_lock<std::mutex> lk(cv_m); std::cout << "Waiting... \n"; cv.wait(lk, []{ return i == 1; }); std::cout << "...finished waiting; i == " << i << '\n'; done = true; } void signals() { std::this_thread::sleep_for(200ms); std::cout << "Notifying falsely...\n"; cv.notify_one(); // waiting thread is notified with i == 0. // cv.wait wakes up, checks i, and goes back to waiting std::unique_lock<std::mutex> lk(cv_m); i = 1; while (!done) { std::cout << "Notifying true change...\n"; lk.unlock(); cv.notify_one(); // waiting thread is notified with i == 1, cv.wait returns std::this_thread::sleep_for(300ms); lk.lock(); } } int main() { std::thread t1(waits), t2(signals); t1.join(); t2.join(); }
可能的输出
Waiting... Notifying falsely... Notifying true change... ...finished waiting; i == 1
[编辑] 另请参见
| 通知所有等待线程 (公有成员函数) | |
| C 文档 for cnd_signal
| |
