Struct std::task::Waker

#[repr(transparent)]
pub struct Waker { /* fields omitted */ }

Waker 是通过通知执行者准备运行来唤醒任务的句柄。

该句柄封装了 RawWaker 实例，该实例定义了特定于执行者的唤醒行为。

实现 Clone，Send 和 Sync。

Implementations

impl Waker

pub fn wake(self)

唤醒与此 Waker 相关的任务。

pub fn wake_by_ref(&self)

唤醒与此 Waker 相关的任务，而不消耗 Waker。

这与 wake 相似，但是在拥有 Waker 的情况下效率可能稍低。 此方法应该比调用 waker.clone().wake() 更可取。

pub fn will_wake(&self, other: &Waker) -> bool

如果此 Waker 和另一个 Waker 唤醒了同一任务，则返回 true。

该函数在尽力而为的基础上起作用，即使 Wakers 唤醒相同的任务，也可能返回 false。 但是，如果此函数返回 true，则可以确保 Waker 唤醒相同的任务。

该函数主要用于优化目的。

pub unsafe fn from_raw(waker: RawWaker) -> Waker

从 RawWaker 创建一个新的 Waker。

如果未遵守 [RawWaker] 和 [RawWakerVTable] 文档中定义的契约，则返回的 Waker` 的行为是不确定的。

因此，此方法是不安全的。

Trait Implementations

impl Clone for Waker

pub fn clone(&self) -> Waker

返回值的副本。

fn clone_from(&mut self, source: &Self)

从 source 执行复制分配。

impl Debug for Waker

pub fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

使用给定的格式化程序格式化该值。

impl Drop for Waker

pub fn drop(&mut self)

执行此类型的析构函数。

impl<W> From<Arc<W>> for Waker where
    W: 'static + Wake + Send + Sync, 

pub fn from(waker: Arc<W>) -> Waker

使用 Wake 类型作为 Waker。

此转换不使用堆分配或原子操作。

impl Send for Waker

impl Sync for Waker

impl Unpin for Waker