Struct Timer

pub struct Timer(/* private fields */);

Waits for a specific time.

Use TimerListener::sleep, TimerListener::sleep_ms, TimerListener::sleep_ticks, or TimerListener::sleep_until to create a Timer.

The timer can be rescheduled with the reschedule series of functions. If the original time period has already passed, it will re-trigger after the new time period.

The calculator is automatically put to sleep until the next timer to conserve power.

use ndless_async::task::{block_on, AsyncListeners};

let listeners = AsyncListeners::new();
block_on(&listeners, async {
    let late_by = listeners.timer().sleep_ms(1000).await;
    println!("Done sleeping! This event was expected {:?} ago", late_by);
});

Implementations

impl Timer

pub fn at_tick(&self) -> u32

Get the tick that this timer should fire at

pub fn reschedule_ms(&self, ms: u32)

Reschedules this timer for the specified number of milliseconds. Problems will occur when sleeping for more than 2^31/32768 seconds, which is about 18 hours.

If this timer has already triggered, it will trigger again after the specified delay.

pub fn reschedule(&self, dur: Duration)

Reschedules this timer for the specified Duration. Problems will occur when sleeping for more than 2^31/32768 seconds, which is about 18 hours.

If this timer has already triggered, it will trigger again after the specified delay.

This function has a resolution of 30 μs.

pub fn reschedule_ticks(&self, ticks: u32)

Reschedules this timer for the specified number of ticks. Problems will occur when sleeping for more than 2^31 ticks, which is about 18 hours.

If this timer has already triggered, it will trigger again after the specified delay.

pub fn reschedule_at(&self, ticks: u32)

Reschedules this timer until the current number of ticks is equal to the parameter. Problems will occur when sleeping for more than 2^31 ticks in the future, which is about 18 hours.

If this timer has already triggered, it will trigger again after the specified delay.

Trait Implementations

impl Future for Timer

type Output = Duration

The difference between now and when this event should have occurred.

fn poll(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll<Self::Output>

Attempts to resolve the future to a final value, registering the current task for wakeup if the value is not yet available.