maybe_static

Crates.iomaybe_static
lib.rsmaybe_static
version0.1.3
sourcesrc
created_at2022-06-30 10:03:51.54046
updated_at2023-04-20 09:16:06.527829
descriptionInitialize a lazy static with params, create Meyer's singleton
homepage
repositoryhttps://github.com/adrien-zinger/maybe_static
max_upload_size
id616296
size6,528
Adrien Zinger (adrien-zinger)

documentation

README

Maybe static

Initialize in a lazy way a static variable with parameters.

Example of a simple usage:

use maybe_static::maybe_static;

pub fn get_lazy(opt: Option<(&str, &str)>) -> Result<&'static String, &'static str> {
    maybe_static!(opt, String, |(a, b)| format!("{a}:{b}"))
}

fn main() {
    println!("{}", get_lazy(Some(("hello", "world"))).unwrap());
    println!("{}", get_lazy(None).unwrap());
}

The macro will create a local static variable that is initialized once, ONLY ONCE. It's also totally thread safe.

fn main() {
    println!("{}", get_lazy(Some(("hello", "world"))).unwrap());
    // print hello:world (initialize)
    println!("{}", get_lazy(None).unwrap());
    // print hello:world
    println!("{}", get_lazy(Some(("foo", "bar"))).unwrap());
    // still print hello:world
}

Require a Some for the first initialization.

fn main() {
    println!("{}", get_lazy(None).unwrap()); // Error!
}

Create a new unique value by scope.

fn main() {
    let a = maybe_static!(Some(("hello", "world")), String, |(a, b)| format!(
        "{a}:{b}"
    ))
    .unwrap();
    let b = maybe_static!(Some(("foo", "bar")), String, |(a, b)| format!(
        "{a}:{b}"
    ))
    .unwrap();
    println!("{a}\n{b}")
    // hello:world
    // foo:bar


    for i in 0..3 {
        print!("{}", maybe_static!(Some(i), usize, |i| i).unwrap());
    }
    // 000
}

Initially developed around the article in the maybeuninit blog

Commit count: 8

cargo fmt