Struct Sender

pub struct Sender<T> { /* private fields */ }

The transmission end of a channel which is used to send values.

This is created by the channel method.

Implementations

impl<T> Sender<T>

pub fn try_send(&mut self, msg: T) -> Result<(), TrySendError<T>>

Attempts to send a message on this Sender<T> without blocking.

This function, unlike start_send, is safe to call whether it’s being called on a task or not. Note that this function, however, will not attempt to block the current task if the message cannot be sent.

It is not recommended to call this function from inside of a future, only from an external thread where you’ve otherwise arranged to be notified when the channel is no longer full.

pub fn poll_ready(&mut self) -> Poll<(), SendError<()>>

Polls the channel to determine if there is guaranteed to be capacity to send at least one item without waiting.

Returns Ok(Async::Ready(_)) if there is sufficient capacity, or returns Ok(Async::NotReady) if the channel is not guaranteed to have capacity. Returns Err(SendError(_)) if the receiver has been dropped.

Panics

This method will panic if called from outside the context of a task or future.

Trait Implementations

impl<T> Clone for Sender<T>

fn clone(&self) -> Sender<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for Sender<T>

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

Formats the value using the given formatter.

impl<T> Drop for Sender<T>

fn drop(&mut self)

Executes the destructor for this type.

impl<T> Sink for Sender<T>

type SinkItem = T

The type of value that the sink accepts.

type SinkError = SendError<T>

The type of value produced by the sink when an error occurs.

fn start_send(&mut self, msg: T) -> StartSend<T, SendError<T>>

Begin the process of sending a value to the sink.

fn poll_complete(&mut self) -> Poll<(), SendError<T>>

Flush all output from this sink, if necessary.

fn close(&mut self) -> Poll<(), SendError<T>>

A method to indicate that no more values will ever be pushed into this sink.

fn wait(self) -> Wait<Self>

where Self: Sized,

Creates a new object which will produce a synchronous sink.

fn with<U, F, Fut>(self, f: F) -> With<Self, U, F, Fut>

where F: FnMut(U) -> Fut, Fut: IntoFuture<Item = Self::SinkItem>, <Fut as IntoFuture>::Error: From<Self::SinkError>, Self: Sized,

Composes a function in front of the sink.

fn with_flat_map<U, F, St>(self, f: F) -> WithFlatMap<Self, U, F, St>

where F: FnMut(U) -> St, St: Stream<Item = Self::SinkItem, Error = Self::SinkError>, Self: Sized,

Composes a function in front of the sink.

fn sink_map_err<F, E>(self, f: F) -> SinkMapErr<Self, F>

where F: FnOnce(Self::SinkError) -> E, Self: Sized,

Transforms the error returned by the sink.

fn sink_from_err<E>(self) -> SinkFromErr<Self, E>

where E: From<Self::SinkError>, Self: Sized,

Map this sink’s error to any error implementing From for this sink’s Error, returning a new sink.

fn buffer(self, amt: usize) -> Buffer<Self>

where Self: Sized,

Adds a fixed-size buffer to the current sink.

fn fanout<S>(self, other: S) -> Fanout<Self, S>

where Self: Sized, Self::SinkItem: Clone, S: Sink<SinkItem = Self::SinkItem, SinkError = Self::SinkError>,

Fanout items to multiple sinks.

fn flush(self) -> Flush<Self>

where Self: Sized,

A future that completes when the sink has finished processing all pending requests.

fn send(self, item: Self::SinkItem) -> Send<Self>

where Self: Sized,

A future that completes after the given item has been fully processed into the sink, including flushing.

fn send_all<S>(self, stream: S) -> SendAll<Self, S>

where S: Stream<Item = Self::SinkItem>, Self::SinkError: From<<S as Stream>::Error>, Self: Sized,

A future that completes after the given stream has been fully processed into the sink, including flushing.