命名空间
变体
操作

std::condition_variable::notify_one

来自 cppreference.com
 
 
并发支持库
线程
(C++11)
(C++20)
this_thread 命名空间
(C++11)
(C++11)
(C++11)
协作取消
互斥
(C++11)
通用锁管理
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
条件变量
(C++11)
信号量
闩锁和屏障
(C++20)
(C++20)
期货
(C++11)
(C++11)
(C++11)
(C++11)
安全回收
(C++26)
危险指针
原子类型
(C++11)
(C++20)
原子类型的初始化
(C++11)(C++20 中已弃用)
(C++11)(C++20 中已弃用)
内存排序
原子操作的自由函数
原子标志的自由函数
 
 
void notify_one() noexcept;
(自 C++11 起)

如果任何线程正在等待 *this,则调用 notify_one 将解阻塞其中一个正在等待的线程。

内容

[编辑] 参数

(无)

[编辑] 返回值

(无)

[编辑] 说明

notify_one()/notify_all()wait()/wait_for()/wait_until() 的三个原子部分(解锁+等待、唤醒和锁定)的效果按单个总顺序发生,该顺序可以看作是原子变量的修改顺序:该顺序特定于此单个条件变量。这使得 notify_one() 无法(例如)延迟并解阻塞在调用 notify_one() 之后才开始等待的线程。

通知线程不需要持有与等待线程(s)持有的相同的互斥锁;事实上这样做是一种悲观优化,因为被通知的线程将立即再次阻塞,等待通知线程释放锁。但是,一些实现(特别是许多 pthreads 实现)识别这种情况并通过将等待线程从条件变量的队列直接转移到互斥锁的队列中来避免这种“赶快等待”场景,而无需唤醒它。

在锁定下进行通知可能仍然是必要的,当需要对事件进行精确调度时,例如,如果等待线程在满足条件时将退出程序,导致通知线程的条件变量被销毁。在解锁互斥锁但通知之前发生的虚假唤醒将导致对已销毁对象的通知。

[编辑] 示例

#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

[编辑] 另请参见

通知所有等待的线程
(公共成员函数) [编辑]
C 文档 for cnd_signal