#reference #static #share #thread #global #ref #function

global-ref

A crate to share references between functions through statics

1 unstable release

0.1.0 Jan 3, 2022

#2994 in Rust patterns

21 downloads per month

MIT license

8KB
148 lines

global-ref

Overview

This crate is used to share references between functions through statics.

Because the implementation internally converts raw pointers to usize and shares them between threads, fetching references is essentially unsafe. If you use this crate, please verify its safety before using it.

Examples

use std::thread;
use global_ref::GlobalMut;

fn main() {
    static GLOBAL: GlobalMut<i32> = GlobalMut::new();

    let mut content = 0;

    GLOBAL.with(&mut content, || {
        fn add_one() {
            *GLOBAL.get_mut() += 1;
        }

        let handle = thread::spawn(add_one);
        handle.join().unwrap();
        assert_eq!(*GLOBAL.get(), 1);
    });

    assert!(GLOBAL.try_get().is_none());
}

License

MIT

Dependencies

~48KB