Crate atomic_cell

This crate provides a thread-safe mutable memory location called AtomicCell.

This type is equivalent to Cell, except it can also be shared among multiple threads.

How it Works

When constructing an AtomicCell, callers select an AtomicStorage implementation that will fit the data they wish to store. (e.g. AtomicU8 can be used to hold a #[repr(u8)] enum)

Under the hood, the desired type is transmuted to the corresponding base type of the storage, and atomic operations are executed on the storage.

The result is that the user should be able to seamlessly interact with the AtomicCell almost as if it were a native atomic.

Two implementations are defined generic and macros. The generic implementation relies on the AtomicStorage trait, whereas the macros implementation relies on the bare functions. This enables the macros implementation to have slightly more const functions in stable rust.

Modules

atomic

The AtomicStorage trait and associated components

compare_update

The CompareUpdate trait used for AtomicCell::compare_update_raw

generic

An implementation of AtomicCell using generics to enable different AtomicStorage backends

macros

Implementations of AtomicCell using macros to enable different AtomicStorage backends

Type Definitions

AtomicCell

A thread-safe mutable memory location.