Struct PollFd

pub struct PollFd { /* private fields */ }

This is a wrapper around libc::pollfd.

It’s meant to be used as an argument to the poll and ppoll functions to specify the events of interest for a specific file descriptor.

After a call to poll or ppoll, the events that occurred can be retrieved by calling revents() on the PollFd.

Implementations

impl PollFd

pub const fn new(fd: RawFd, events: PollFlags) -> PollFd

Creates a new PollFd specifying the events of interest for a given file descriptor.

pub fn revents(self) -> Option<PollFlags>

Returns the events that occurred in the last call to poll or ppoll. Will only return None if the kernel provides status flags that Nix does not know about.

pub fn any(self) -> Option<bool>

Returns if any of the events of interest occured in the last call to poll or ppoll. Will only return None if the kernel provides status flags that Nix does not know about.

Equivalent to x.revents()? != PollFlags::empty().

This is marginally more efficient than PollFd::all.

pub fn all(self) -> Option<bool>

Returns if all the events of interest occured in the last call to poll or ppoll. Will only return None if the kernel provides status flags that Nix does not know about.

Equivalent to x.revents()? & x.events() == x.events().

This is marginally less efficient than PollFd::any.

pub fn events(self) -> PollFlags

The events of interest for this PollFd.

pub fn set_events(&mut self, events: PollFlags)

Modify the events of interest for this PollFd.

Trait Implementations

impl AsRawFd for PollFd

fn as_raw_fd(&self) -> RawFd

Extracts the raw file descriptor.

impl Clone for PollFd

fn clone(&self) -> PollFd

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for PollFd

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

Formats the value using the given formatter.

impl Hash for PollFd

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for PollFd

fn eq(&self, other: &PollFd) -> 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 PollFd

impl Eq for PollFd

impl StructuralPartialEq for PollFd