impl<T> Receiver<T>

fn try_recv(self: &Self) -> Result<T, TryRecvError>

Attempts to receive a message from the channel without blocking.

This method will either receive a message from the channel immediately or return an error if the channel is empty.

If called on a zero-capacity channel, this method will receive a message only if there happens to be a send operation on the other side of the channel at the same time.

Examples

use crossbeam_channel::{unbounded, TryRecvError};

let (s, r) = unbounded();
assert_eq!(r.try_recv(), Err(TryRecvError::Empty));

s.send(5).unwrap();
drop(s);

assert_eq!(r.try_recv(), Ok(5));
assert_eq!(r.try_recv(), Err(TryRecvError::Disconnected));

fn recv(self: &Self) -> Result<T, RecvError>

Blocks the current thread until a message is received or the channel is empty and disconnected.

If the channel is empty and not disconnected, this call will block until the receive operation can proceed. If the channel is empty and becomes disconnected, this call will wake up and return an error.

If called on a zero-capacity channel, this method will wait for a send operation to appear on the other side of the channel.

Examples

use std::thread;
use std::time::Duration;
use crossbeam_channel::{unbounded, RecvError};

let (s, r) = unbounded();

thread::spawn(move || {
    thread::sleep(Duration::from_secs(1));
    s.send(5).unwrap();
    drop(s);
});

assert_eq!(r.recv(), Ok(5));
assert_eq!(r.recv(), Err(RecvError));

fn recv_timeout(self: &Self, timeout: Duration) -> Result<T, RecvTimeoutError>

Waits for a message to be received from the channel, but only for a limited time.

If the channel is empty and not disconnected, this call will block until the receive operation can proceed or the operation times out. If the channel is empty and becomes disconnected, this call will wake up and return an error.

If called on a zero-capacity channel, this method will wait for a send operation to appear on the other side of the channel.

Examples

use std::thread;
use std::time::Duration;
use crossbeam_channel::{unbounded, RecvTimeoutError};

let (s, r) = unbounded();

thread::spawn(move || {
    thread::sleep(Duration::from_secs(1));
    s.send(5).unwrap();
    drop(s);
});

assert_eq!(
    r.recv_timeout(Duration::from_millis(500)),
    Err(RecvTimeoutError::Timeout),
);
assert_eq!(
    r.recv_timeout(Duration::from_secs(1)),
    Ok(5),
);
assert_eq!(
    r.recv_timeout(Duration::from_secs(1)),
    Err(RecvTimeoutError::Disconnected),
);

fn recv_deadline(self: &Self, deadline: Instant) -> Result<T, RecvTimeoutError>

Waits for a message to be received from the channel, but only before a given deadline.

If the channel is empty and not disconnected, this call will block until the receive operation can proceed or the operation times out. If the channel is empty and becomes disconnected, this call will wake up and return an error.

If called on a zero-capacity channel, this method will wait for a send operation to appear on the other side of the channel.

Examples

use std::thread;
use std::time::{Instant, Duration};
use crossbeam_channel::{unbounded, RecvTimeoutError};

let (s, r) = unbounded();

thread::spawn(move || {
    thread::sleep(Duration::from_secs(1));
    s.send(5).unwrap();
    drop(s);
});

let now = Instant::now();

assert_eq!(
    r.recv_deadline(now + Duration::from_millis(500)),
    Err(RecvTimeoutError::Timeout),
);
assert_eq!(
    r.recv_deadline(now + Duration::from_millis(1500)),
    Ok(5),
);
assert_eq!(
    r.recv_deadline(now + Duration::from_secs(5)),
    Err(RecvTimeoutError::Disconnected),
);

fn is_empty(self: &Self) -> bool

Returns true if the channel is empty.

Note: Zero-capacity channels are always empty.

Examples

use crossbeam_channel::unbounded;

let (s, r) = unbounded();

assert!(r.is_empty());
s.send(0).unwrap();
assert!(!r.is_empty());

fn is_full(self: &Self) -> bool

Returns true if the channel is full.

Note: Zero-capacity channels are always full.

Examples

use crossbeam_channel::bounded;

let (s, r) = bounded(1);

assert!(!r.is_full());
s.send(0).unwrap();
assert!(r.is_full());

fn len(self: &Self) -> usize

Returns the number of messages in the channel.

Examples

use crossbeam_channel::unbounded;

let (s, r) = unbounded();
assert_eq!(r.len(), 0);

s.send(1).unwrap();
s.send(2).unwrap();
assert_eq!(r.len(), 2);

fn capacity(self: &Self) -> Option<usize>

If the channel is bounded, returns its capacity.

Examples

use crossbeam_channel::{bounded, unbounded};

let (_, r) = unbounded::<i32>();
assert_eq!(r.capacity(), None);

let (_, r) = bounded::<i32>(5);
assert_eq!(r.capacity(), Some(5));

let (_, r) = bounded::<i32>(0);
assert_eq!(r.capacity(), Some(0));

fn iter(self: &Self) -> Iter<'_, T>

A blocking iterator over messages in the channel.

Each call to next blocks waiting for the next message and then returns it. However, if the channel becomes empty and disconnected, it returns None without blocking.

Examples

use std::thread;
use crossbeam_channel::unbounded;

let (s, r) = unbounded();

thread::spawn(move || {
    s.send(1).unwrap();
    s.send(2).unwrap();
    s.send(3).unwrap();
    drop(s); // Disconnect the channel.
});

// Collect all messages from the channel.
// Note that the call to `collect` blocks until the sender is dropped.
let v: Vec<_> = r.iter().collect();

assert_eq!(v, [1, 2, 3]);

fn try_iter(self: &Self) -> TryIter<'_, T>

A non-blocking iterator over messages in the channel.

Each call to next returns a message if there is one ready to be received. The iterator never blocks waiting for the next message.

Examples

use std::thread;
use std::time::Duration;
use crossbeam_channel::unbounded;

let (s, r) = unbounded::<i32>();

thread::spawn(move || {
    s.send(1).unwrap();
    thread::sleep(Duration::from_secs(1));
    s.send(2).unwrap();
    thread::sleep(Duration::from_secs(2));
    s.send(3).unwrap();
});

thread::sleep(Duration::from_secs(2));

// Collect all messages from the channel without blocking.
// The third message hasn't been sent yet so we'll collect only the first two.
let v: Vec<_> = r.try_iter().collect();

assert_eq!(v, [1, 2]);

fn same_channel(self: &Self, other: &Receiver<T>) -> bool

Returns true if receivers belong to the same channel.

Examples

use crossbeam_channel::unbounded;

let (_, r) = unbounded::<usize>();

let r2 = r.clone();
assert!(r.same_channel(&r2));

let (_, r3) = unbounded();
assert!(!r.same_channel(&r3));

impl<T> Any for Receiver<T>

fn type_id(self: &Self) -> TypeId

impl<T> Borrow for Receiver<T>

fn borrow(self: &Self) -> &T

impl<T> BorrowMut for Receiver<T>

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

impl<T> Clone for Receiver<T>

fn clone(self: &Self) -> Self

impl<T> CloneToUninit for Receiver<T>

unsafe fn clone_to_uninit(self: &Self, dest: *mut u8)

impl<T> Debug for Receiver<T>

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

impl<T> Drop for Receiver<T>

fn drop(self: &mut Self)

impl<T> Freeze for Receiver<T>

impl<T> From for Receiver<T>

fn from(t: T) -> T

Returns the argument unchanged.

impl<T> IntoIterator for Receiver<T>

fn into_iter(self: Self) -> <Self as >::IntoIter

impl<T> RefUnwindSafe for Receiver<T>

impl<T> SelectHandle for Receiver<T>

fn try_select(self: &Self, token: &mut Token) -> bool

fn deadline(self: &Self) -> Option<Instant>

fn register(self: &Self, oper: Operation, cx: &Context) -> bool

fn unregister(self: &Self, oper: Operation)

fn accept(self: &Self, token: &mut Token, cx: &Context) -> bool

fn is_ready(self: &Self) -> bool

fn watch(self: &Self, oper: Operation, cx: &Context) -> bool

fn unwatch(self: &Self, oper: Operation)

impl<T> ToOwned for Receiver<T>

fn to_owned(self: &Self) -> T

fn clone_into(self: &Self, target: &mut T)

impl<T> Unpin for Receiver<T>

impl<T> UnwindSafe for Receiver<T>

impl<T, U> Into for Receiver<T>

fn into(self: Self) -> U

Calls U::from(self).

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

impl<T, U> TryFrom for Receiver<T>

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

impl<T, U> TryInto for Receiver<T>

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

impl<T: Send> Send for Receiver<T>

impl<T: Send> Sync for Receiver<T>