pub fn at(when: Instant) -> Receiver<Instant>
Expand description

Creates a receiver that delivers a message at a certain instant in time.

The channel is bounded with capacity of 1 and never gets disconnected. Exactly one message will be sent into the channel at the moment in time when. The message is the instant at which it is sent, which is the same as when. If when is in the past, the message will be delivered instantly to the receiver.

Examples

Using an at channel for timeouts:

use std::time::{Instant, Duration};
use crossbeam_channel::{at, select, unbounded};

let (s, r) = unbounded::<i32>();
let deadline = Instant::now() + Duration::from_millis(500);

select! {
    recv(r) -> msg => println!("received {:?}", msg),
    recv(at(deadline)) -> _ => println!("timed out"),
}

When the message gets sent:

use std::time::{Duration, Instant};
use crossbeam_channel::at;

// Converts a number of milliseconds into a `Duration`.
let ms = |ms| Duration::from_millis(ms);

let start = Instant::now();
let end = start + ms(100);

let r = at(end);

// This message was sent 100 ms from the start
assert_eq!(r.recv().unwrap(), end);
assert!(Instant::now() > start + ms(100));