这是线程之间通信的最简单机制之一:一个线程发出事件信号,而其他线程等待该信号。

实现事件对象的类。事件对象管理一个内部标识,调用 set() 方法可将其设置为true。调用 clear() 方法可将其设置为 false 。调用 wait() 方法将进入阻塞直到标识为true。这个标识初始时为 false 。

—官方

通俗点的理解:Event创建时,在内部维护一个全局_flag默认为False。那么使用wait线程就会阻塞。只到_flag变为True线程继续运行。_flag就是官方说的信号。Event实现了基于线程安全的事件。原因是内部维护的_cond

常用方法

is_set

当且仅当内部标识为 true 时返回 True注意isSet 方法是此方法的已弃用别名。

set

将内部标识设置为 true 。所有正在等待这个事件的线程将被唤醒。当标识为 true 时,调用 wait() 方法的线程不会被被阻塞。

wait

wait(timeount=None)

阻塞线程直到内部变量为 true 。如果调用时内部标识为 true,将立即返回。否则将阻塞线程,直到调用 set() 方法将标识设置为 true 或者发生可选的超时。

当提供了timeout参数且不是 None 时,它应该是一个浮点数,代表操作的超时时间,以秒为单位(可以为小数)。

当且仅当内部旗标在等待调用之前或者等待开始之后被设为真值时此方法将返回 True,也就是说,它将总是返回 True 除非设定了超时且操作发生了超时。

clear

将内部标识设置为 false 。之后调用 wait() 方法的线程将会被阻塞,直到调用 set() 方法将内部标识再次设置为 true 。

注意已经set再次使用不生效。如果,循环唤醒线程使用clear后再次setwait拥有同样的性质。

通过一小段代码能清楚发现问题

from threading import Thread, Event
import time


e = Event()
flag = True

def test(e):
    i = 1
    while i < 10:
        if flag:
            e.clear()
            e.wait()
        print(i)
        i += 1
        time.sleep(3)
t = Thread(target=test, args=(e, ))
t.start()
# 通过不断变换 flag

事件案例