set_interval

Crates.ioset_interval
lib.rsset_interval
version0.1.1
sourcesrc
created_at2022-11-10 21:19:29.603677
updated_at2022-11-10 22:21:25.858378
descriptionCall a subroutine at a constant time interval
homepagehttps://github.com/bleaklake/rust_set_interval
repositoryhttps://github.com/bleaklake/rust_set_interval
max_upload_size
id712420
size8,891
bleaklake (bleaklake)

documentation

https://github.com/bleaklake/rust_set_interval/blob/master/README.md

README

set_interval

Call a subroutine at a constant time interval.

Examples

Basic

use std::{thread, time::Duration};
use set_interval;

fn on_tick() {
    println!("tick!");
}

fn main() {
    let cancel = set_interval::set_interval(&on_tick, Duration::from_millis(500));

    // Waiting before cancelling this instance of set_interval.
    thread::sleep(Duration::from_secs(3));

    cancel();

    println!("This instance of set_interval has been succesfully stopped");

    // Sleeping for a long time for the sake of this example.
    thread::sleep(Duration::from_millis(u64::MAX));
}

Inner function

use std::{thread, time::Duration};
use set_interval;

fn main() {
    let on_tick = || {
        println!("tick!");
    };

    // Leaking this inner function to make its lifetime as 'static.
    // https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
    let static_on_tick = Box::leak(Box::new(on_tick));

    let cancel = set_interval::set_interval(static_on_tick, Duration::from_millis(500));

    // Waiting before cancelling this instance of set_interval.
    thread::sleep(Duration::from_secs(3));

    cancel();

    println!("This instance of set_interval has been succesfully stopped");

    // Sleeping for a long time for the sake of this example.
    thread::sleep(Duration::from_millis(u64::MAX));
}

Capturing inner function

use std::{
    sync::{Arc, Mutex},
    thread,
    time::Duration,
};

fn main() {
    // The data shared with the given callback has to be thread-safe.
    // https://doc.rust-lang.org/nomicon/send-and-sync.html
    let counter = Arc::new(Mutex::new(10));
    let cancel_option: Arc<Mutex<Option<Box<dyn Fn() + Send + 'static>>>> =
        Arc::new(Mutex::new(None));
    let cancel_option_clone = cancel_option.clone();

    let on_tick = move || {
        let mut c = counter.lock().unwrap();
        if *c == 0 {
            cancel_option_clone.lock().unwrap().as_ref().unwrap()();
            println!("We have a liftoff!");
            println!("This instance of set_interval has been succesfully stopped");
        } else {
            println!("{}", c);
            *c -= 1;
        }
    };

    // Leaking this inner function to make its lifetime as 'static.
    // https://doc.rust-lang.org/std/boxed/struct.Box.html#method.leak
    let static_on_tick = Box::leak(Box::new(on_tick));

    let cancel = set_interval::set_interval(static_on_tick, Duration::from_secs(1));

    *cancel_option.lock().unwrap() = Some(cancel);

    // Sleeping for a long time for the sake of this example.
    thread::sleep(Duration::from_millis(u64::MAX));
}

Commit count: 0

cargo fmt