Struct Interest 

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

Available on crate feature net, or tokio_unstable and crate feature io-uring and crate feature rt and crate feature fs and Linux only.

Readiness event interest.

Specifies the readiness events the caller is interested in when awaiting on I/O resource readiness states.

Implementations

impl Interest

pub const AIO: Interest

Available on FreeBSD and crate feature net only.

Interest for POSIX AIO.

pub const LIO: Interest

Available on FreeBSD and crate feature net only.

Interest for POSIX AIO lio_listio events.

pub const READABLE: Interest

Available on crate feature net, or Unix and crate feature process, or Unix and crate feature signal, or tokio_unstable and crate feature io-uring and crate feature rt and crate feature fs and Linux only.

Interest in all readable events.

Readable interest includes read-closed events.

pub const WRITABLE: Interest

Available on crate feature net, or Unix and crate feature process, or Unix and crate feature signal, or tokio_unstable and crate feature io-uring and crate feature rt and crate feature fs and Linux only.

Interest in all writable events.

Writable interest includes write-closed events.

pub const ERROR: Interest

Available on crate feature net, or Unix and crate feature process, or Unix and crate feature signal, or tokio_unstable and crate feature io-uring and crate feature rt and crate feature fs and Linux only.

Interest in error events.

Passes error interest to the underlying OS selector. Behavior is platform-specific, read your platform’s documentation.

pub const PRIORITY: Interest

Available on Linux or Android only.

Returns a Interest set representing priority completion interests.

pub const fn is_readable(self) -> bool

Available on crate feature net, or Unix and crate feature process, or Unix and crate feature signal, or tokio_unstable and crate feature io-uring and crate feature rt and crate feature fs and Linux only.

Returns true if the value includes readable interest.

Examples

use tokio::io::Interest;

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

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

pub const fn is_writable(self) -> bool

Available on crate feature net, or Unix and crate feature process, or Unix and crate feature signal, or tokio_unstable and crate feature io-uring and crate feature rt and crate feature fs and Linux only.

Returns true if the value includes writable interest.

Examples

use tokio::io::Interest;

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

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

pub const fn is_error(self) -> bool

Available on crate feature net, or Unix and crate feature process, or Unix and crate feature signal, or tokio_unstable and crate feature io-uring and crate feature rt and crate feature fs and Linux only.

Returns true if the value includes error interest.

Examples

use tokio::io::Interest;

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

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

pub const fn is_priority(self) -> bool

Available on Linux or Android only.

Returns true if the value includes priority interest.

Examples

use tokio::io::Interest;

assert!(!Interest::READABLE.is_priority());
assert!(Interest::PRIORITY.is_priority());

let both = Interest::READABLE | Interest::PRIORITY;
assert!(both.is_priority());

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

Available on crate feature net, or Unix and crate feature process, or Unix and crate feature signal, or tokio_unstable and crate feature io-uring and crate feature rt and crate feature fs and Linux only.

Add together two Interest values.

This function works from a const context.

Examples

use tokio::io::Interest;

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

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

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

Available on crate feature net, or Unix and crate feature process, or Unix and crate feature signal, or tokio_unstable and crate feature io-uring and crate feature rt and crate feature fs and Linux only.

Remove Interest from self.

Interests present in other but not in self are ignored.

Returns None if the set would be empty after removing Interest.

Examples

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);

Trait Implementations

impl BitOr for Interest

Available on crate feature net, or Unix and crate feature process, or Unix and crate feature signal, or tokio_unstable and crate feature io-uring and crate feature rt and crate feature fs and Linux only.

type Output = Interest

The resulting type after applying the | operator.

fn bitor(self, other: Self) -> Self

Performs the | operation.

impl BitOrAssign for Interest

Available on crate feature net, or Unix and crate feature process, or Unix and crate feature signal, or tokio_unstable and crate feature io-uring and crate feature rt and crate feature fs and Linux only.

fn bitor_assign(&mut self, other: Self)

Performs the |= operation.

impl Clone for Interest

Available on crate feature net, or Unix and crate feature process, or Unix and crate feature signal, or tokio_unstable and crate feature io-uring and crate feature rt and crate feature fs and Linux only.

fn clone(&self) -> Interest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Interest

Available on crate feature net, or Unix and crate feature process, or Unix and crate feature signal, or tokio_unstable and crate feature io-uring and crate feature rt and crate feature fs and Linux only.

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

Formats the value using the given formatter.

impl PartialEq for Interest

Available on crate feature net, or Unix and crate feature process, or Unix and crate feature signal, or tokio_unstable and crate feature io-uring and crate feature rt and crate feature fs and Linux only.

fn eq(&self, other: &Interest) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for Interest

Available on crate feature net, or Unix and crate feature process, or Unix and crate feature signal, or tokio_unstable and crate feature io-uring and crate feature rt and crate feature fs and Linux only.

impl Eq for Interest

Available on crate feature net, or Unix and crate feature process, or Unix and crate feature signal, or tokio_unstable and crate feature io-uring and crate feature rt and crate feature fs and Linux only.

impl StructuralPartialEq for Interest

Available on crate feature net, or Unix and crate feature process, or Unix and crate feature signal, or tokio_unstable and crate feature io-uring and crate feature rt and crate feature fs and Linux only.