Struct flume::select::Selector

source ·
pub struct Selector<'a, T: 'a> { /* private fields */ }
Expand description

A type used to wait upon multiple blocking operations at once.

A Selector implements select-like behaviour, allowing a thread to wait upon the result of more than one operation at once.

§Examples

let (tx0, rx0) = flume::unbounded();
let (tx1, rx1) = flume::unbounded();

std::thread::spawn(move || {
    tx0.send(true).unwrap();
    tx1.send(42).unwrap();
});

flume::Selector::new()
    .recv(&rx0, |b| println!("Received {:?}", b))
    .recv(&rx1, |n| println!("Received {:?}", n))
    .wait();

Implementations§

source§

impl<'a, T> Selector<'a, T>

source

pub fn new() -> Self

Create a new selector.

source

pub fn send<U, F: FnMut(Result<(), SendError<U>>) -> T + 'a>( self, sender: &'a Sender<U>, msg: U, mapper: F, ) -> Self

Add a send operation to the selector that sends the provided value.

Once added, the selector can be used to run the provided handler function on completion of this operation.

source

pub fn recv<U, F: FnMut(Result<U, RecvError>) -> T + 'a>( self, receiver: &'a Receiver<U>, mapper: F, ) -> Self

Add a receive operation to the selector.

Once added, the selector can be used to run the provided handler function on completion of this operation.

source

pub fn wait(self) -> T

Wait until one of the events associated with this Selector has completed. If the eventual-fairness feature flag is enabled, this method is fair and will handle a random event of those that are ready.

source

pub fn wait_timeout(self, dur: Duration) -> Result<T, SelectError>

Wait until one of the events associated with this Selector has completed or the timeout has expired. If the eventual-fairness feature flag is enabled, this method is fair and will handle a random event of those that are ready.

source

pub fn wait_deadline(self, deadline: Instant) -> Result<T, SelectError>

Wait until one of the events associated with this Selector has completed or the deadline has been reached. If the eventual-fairness feature flag is enabled, this method is fair and will handle a random event of those that are ready.

Trait Implementations§

source§

impl<'a, T: 'a> Debug for Selector<'a, T>

source§

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

Formats the value using the given formatter. Read more
source§

impl<'a, T: 'a> Default for Selector<'a, T>

source§

fn default() -> Self

Returns the “default value” for a type. Read more

Auto Trait Implementations§

§

impl<'a, T> Freeze for Selector<'a, T>

§

impl<'a, T> !RefUnwindSafe for Selector<'a, T>

§

impl<'a, T> !Send for Selector<'a, T>

§

impl<'a, T> !Sync for Selector<'a, T>

§

impl<'a, T> Unpin for Selector<'a, T>

§

impl<'a, T> !UnwindSafe for Selector<'a, T>

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

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

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.