atomiconcecell

atomic_once_cell provides two new types, [AtomicOnceCell] and [AtomicLazy], which are thread-safe and mostly lock-free drop-in replacements of [core::lazy::OnceCell] and [core::lazy::Lazy] suitable for use in #[no_std] environments.

Blocking

Because dereferencing [AtomicLazy] can't fail, it can't be lock-free (if you know a way, please tell me).

Both types can be used in a non-blocking way, but there are some blocking calls that should not be used from interrupt handlers or other contexts where blocking will lead to a deadlock. Blocking is based on crossbeam::utils::Backoff, and will be reduced to a spinlock in #[no_std] environments.

Examples

AtomicOnceCell

```rust use atomiconcecell::AtomicOnceCell;

static CELL: AtomicOnceCell = AtomicOnceCell::new();

fn main() { CELL.set("Hello, World!".to_owned()).unwrap();

assert_eq!(*CELL.get().unwrap(), "Hello, World!");

} ```

AtomicLazy

```rust use atomiconcecell::AtomicLazy;

static LAZY: AtomicLazy = AtomicLazy::new(|| "Hello, World!".to_owned());

fn main() { assert_eq!(*LAZY, "Hello, World!"); } ```

For more details, see docs.

Usage

Add this to your Cargo.toml:

toml [dependencies] atomic_once_cell = "0.1.5"

License

MPL-2.0