tokio::io

结构体 Interest

pub struct Interest(/* private fields */);

展开描述

就绪事件关注项（interest）。

指定在等待 I/O 资源就绪状态时调用方感兴趣的就绪事件。

实现§

Source §

impl Interest

Source

pub const READABLE: Interest

对所有可读事件感兴趣。

可读兴趣包含读关闭事件。

Source

pub const WRITABLE: Interest

对所有可写事件感兴趣。

可写兴趣包含写关闭事件。

Source

pub const ERROR: Interest

对错误事件感兴趣。

将错误兴趣传递给底层 OS 选择器。行为因平台而异，请阅读你所使用平台的文档。

Source

pub const fn is_readable(self) -> bool

如果该值包含可读兴趣，则返回 true。

§示例

use tokio::io::Interest;

assert!(Interest::READABLE.is_readable());
assert!(!Interest::WRITABLE.is_readable());

let both = Interest::READABLE | Interest::WRITABLE;
assert!(both.is_readable());

Source

pub const fn is_writable(self) -> bool

如果该值包含可写兴趣，则返回 true。

§示例

use tokio::io::Interest;

assert!(!Interest::READABLE.is_writable());
assert!(Interest::WRITABLE.is_writable());

let both = Interest::READABLE | Interest::WRITABLE;
assert!(both.is_writable());

Source

pub const fn is_error(self) -> bool

如果该值包含错误兴趣，则返回 true。

§示例

use tokio::io::Interest;

assert!(Interest::ERROR.is_error());
assert!(!Interest::WRITABLE.is_error());

let combined = Interest::READABLE | Interest::ERROR;
assert!(combined.is_error());

Source

pub const fn add(self, other: Interest) -> Interest

将两个 Interest 值相加。

此函数可以在 const 上下文中使用。

§示例

use tokio::io::Interest;

const BOTH: Interest = Interest::READABLE.add(Interest::WRITABLE);

assert!(BOTH.is_readable());
assert!(BOTH.is_writable());

Source

pub fn remove(self, other: Interest) -> Option<Interest>

从 self 中移除 Interest。

仅移除 self 中存在的那些 Interest；存在于 other 但不存在于 self 中的兴趣将被忽略。

如果在移除 Interest 后集合为空，则返回 None。

§示例

use tokio::io::Interest;

const RW_INTEREST: Interest = Interest::READABLE.add(Interest::WRITABLE);

let w_interest = RW_INTEREST.remove(Interest::READABLE).unwrap();
assert!(!w_interest.is_readable());
assert!(w_interest.is_writable());

// Removing all interests from the set returns `None`.
assert_eq!(w_interest.remove(Interest::WRITABLE), None);

// Remove all interests at once.
assert_eq!(RW_INTEREST.remove(RW_INTEREST), None);