Struct selecting::Selector

pub struct Selector { /* private fields */ }

Select abstraction allowing you to monitor specified sockets.

Selector itself represents set of file descriptors to monitor, as such it is possible to copy it. Normally select modifies list of file descriptors, but Selector always copies existing list, avoiding these modifications.

Performance recommendations

Generally limited to 64 file descriptors, but you should only use select when you have ~10 fds otherwise modern API like kqueue or epoll would yield much better performance.

• Call select only when getting would block from syscall;
• Limit number of selects, allowing it to accumulate events;

Implementations

impl Selector

pub fn new() -> Self

Creates new instance with no sockets to monitor.

pub fn add_read<T: AsRawFd>(&mut self, source: &T)

Adds source to monitor for read ops.

Panics when goes over FD_LIMIT

pub fn add_write<T: AsRawFd>(&mut self, source: &T)

Adds source to monitor for write ops.

Panics when goes over FD_LIMIT

pub fn add_except<T: AsRawFd>(&mut self, source: &T)

Adds source to monitor for exceptional ops.

Panics when goes over FD_LIMIT

pub fn clear_read(&mut self)

Removes all fds from read monitoring

pub fn clear_write(&mut self)

Removes all fds from write monitoring

pub fn clear_except(&mut self)

Removes all fds from except monitoring

pub fn select(&self) -> Result<SelectResult>

Performs select, awaiting indefinitely until at least one descriptor has changes.

pub fn try_select(&self) -> Result<SelectResult>

Performs select, checking file descriptors for changes and returning immediately.

pub fn select_timeout(&self, time: Duration) -> Result<SelectResult>

Performs select, awaiting at most time until at least one descriptor has changes.

Trait Implementations

impl Clone for Selector

fn clone(&self) -> Selector

Returns a copy of the value.

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

Performs copy-assignment from source.