pub struct Receiver<T> { /* private fields */ }
Expand description
The receiving-half of the channel.
Implementations§
Source§impl<T> Receiver<T>
impl<T> Receiver<T>
Sourcepub fn recv(&self) -> Result<T, RecvError>
pub fn recv(&self) -> Result<T, RecvError>
Attempts to wait for a value on this receiver, returning an error if the corresponding channel has hung up.
This function will always block the current thread if there is no data
available and it’s possible for more data to be sent. Once a message is
sent to the corresponding Sender
, then this receiver will wake up and
return that message.
If the corresponding Sender has disconnected, or it disconnects while
this call is blocking, this call will wake up and return Err
to indicate
that no more messages can ever be received on this channel. However,
since channels are buffered, messages sent before the disconnect will
still be properly received.
Sourcepub fn recv_timeout(&self, timeout: Duration) -> Result<T, RecvTimeoutError>
pub fn recv_timeout(&self, timeout: Duration) -> Result<T, RecvTimeoutError>
Attempts to wait for a value on this receiver, returning an error if the corresponding channel has hung up, or if it waits more than timeout.
This function will always block the current thread if there is no data available and it’s possible for more data to be sent. Once a message is sent to the corresponding Sender, then this receiver will wake up and return that message.
If the corresponding Sender
has disconnected, or it disconnects while
this call is blocking, this call will wake up and return Err
to
indicate that no more messages can ever be received on this channel.
However, since channels are buffered, messages sent before the
disconnect will still be properly received.
Sourcepub fn try_recv(&self) -> Result<T, TryRecvError>
pub fn try_recv(&self) -> Result<T, TryRecvError>
Attempts to return a pending value on this receiver without blocking
This method will never block the caller in order to wait for data to become available. Instead, this will always return immediately with a possible option of pending data on the channel.
This is useful for a flavor of “optimistic check” before deciding to block on a receiver.