pub struct Selector<'a, T>
where 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§

§

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

pub fn new() -> Selector<'a, T>

Create a new selector.

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

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.

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

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.

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.

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.

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§

§

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

§

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

Formats the value using the given formatter. Read more
§

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

§

fn default() -> Selector<'a, T>

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

Auto Trait Implementations§

§

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
§

impl<'a, T, E> AsTaggedExplicit<'a, E> for T
where T: 'a,

§

fn explicit(self, class: Class, tag: u32) -> TaggedParser<'a, Explicit, Self, E>

§

impl<'a, T, E> AsTaggedImplicit<'a, E> for T
where T: 'a,

§

fn implicit( self, class: Class, constructed: bool, tag: u32 ) -> TaggedParser<'a, Implicit, Self, E>

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.

§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
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> Same for T

§

type Output = T

Should always be Self
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.
§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

§

fn vzip(self) -> V

§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more