std::condition_variable::notify_one
来自 cppreference.cn
< cpp | thread | condition variable
| void notify_one() noexcept; |
(自 C++11 起) | |
如果有任何线程正在 *this 上等待，调用 notify_one 将解除阻塞其中一个等待线程。
目录 |
[edit] 参数
(无)
[edit] 返回值
(无)
[edit] 注解
notify_one()/notify_all() 的效果和 wait()/wait_for()/wait_until() 的三个原子部分（解锁+等待、唤醒和加锁）中的每一个都发生在可以看作是原子变量的修改顺序的单个总顺序中：该顺序特定于此单独的条件变量。这使得 notify_one() 不可能例如被延迟并解除阻塞在调用 notify_one() 之后刚开始等待的线程。
通知线程不需要持有与等待线程所持有的互斥锁相同的锁；事实上，这样做是一种悲观化，因为被通知的线程会立即再次阻塞，等待通知线程释放锁。但是，某些实现（特别是 pthreads 的许多实现）认识到这种情况，并通过在通知调用中将等待线程从条件变量的队列直接转移到互斥锁的队列中来避免这种“匆忙等待”的情况，而无需唤醒它。
当需要精确的事件调度时，例如，如果等待线程在条件满足时将退出程序，导致通知线程的条件变量被销毁，则在锁下通知可能仍然是必要的。互斥锁解锁后但在通知之前的虚假唤醒将导致在已销毁的对象上调用通知。
[edit] 示例
运行此代码
#include <chrono> #include <condition_variable> #include <iostream> #include <thread> using namespace std::chrono_literals; std::condition_variable 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
[edit] 参见
| 通知所有等待线程 (公共成员函数) | |
| C 文档 对于 cnd_signal
| |
