[][src]Struct mio::SetReadiness

pub struct SetReadiness { /* fields omitted */ }

Updates the readiness state of the associated Registration.

See Registration for more documentation on using SetReadiness and Poll for high level polling documentation.

Methods

impl SetReadiness[src]

pub fn readiness(&self) -> Ready[src]

Returns the registration's current readiness.

Note

There is no guarantee that readiness establishes any sort of memory ordering. Any concurrent data access must be synchronized using another strategy.

Examples

use mio::{Registration, Ready};

let (registration, set_readiness) = Registration::new2();

assert!(set_readiness.readiness().is_empty());

set_readiness.set_readiness(Ready::readable())?;
assert!(set_readiness.readiness().is_readable());

pub fn set_readiness(&self, ready: Ready) -> Result<()>[src]

Set the registration's readiness

If the associated Registration is registered with a Poll instance and has requested readiness events that include ready, then a future call to Poll::poll will receive a readiness event representing the readiness state change.

Note

There is no guarantee that readiness establishes any sort of memory ordering. Any concurrent data access must be synchronized using another strategy.

There is also no guarantee as to when the readiness event will be delivered to poll. A best attempt will be made to make the delivery in a "timely" fashion. For example, the following is not guaranteed to work:

use mio::{Events, Registration, Ready, Poll, PollOpt, Token};

let poll = Poll::new()?;
let (registration, set_readiness) = Registration::new2();

poll.register(&registration,
              Token(0),
              Ready::readable(),
              PollOpt::edge())?;

// Set the readiness, then immediately poll to try to get the readiness
// event
set_readiness.set_readiness(Ready::readable())?;

let mut events = Events::with_capacity(1024);
poll.poll(&mut events, None)?;

// There is NO guarantee that the following will work. It is possible
// that the readiness event will be delivered at a later time.
let event = events.get(0).unwrap();
assert_eq!(event.token(), Token(0));
assert!(event.readiness().is_readable());

Examples

A simple example, for a more elaborate example, see the Evented documentation.

use mio::{Registration, Ready};

let (registration, set_readiness) = Registration::new2();

assert!(set_readiness.readiness().is_empty());

set_readiness.set_readiness(Ready::readable())?;
assert!(set_readiness.readiness().is_readable());

Trait Implementations

impl Clone for SetReadiness[src]

impl Debug for SetReadiness[src]

impl Send for SetReadiness[src]

impl Sync for SetReadiness[src]

Auto Trait Implementations

impl !RefUnwindSafe for SetReadiness

impl Unpin for SetReadiness

impl !UnwindSafe for SetReadiness

Blanket Implementations

impl<T> Any for T where
    T: 'static + ?Sized
[src]

impl<T> Borrow<T> for T where
    T: ?Sized
[src]

impl<T> BorrowMut<T> for T where
    T: ?Sized
[src]

impl<T> From<T> for T[src]

impl<T, U> Into<U> for T where
    U: From<T>, 
[src]

impl<T> ToOwned for T where
    T: Clone
[src]

type Owned = T

The resulting type after obtaining ownership.

impl<T, U> TryFrom<U> for T where
    U: Into<T>, 
[src]

type Error = Infallible

The type returned in the event of a conversion error.

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 
[src]

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.