Crate option_lock

This crate defines a locking structure wrapping an Option value. The lock can be acquired using a single atomic operation. The OptionLock structure is represented as one atomic u8 variable along with the current value of the lock (which may be empty). It can be constructed in const contexts.

The try_lock and try_take operations are non-blocking and appropriate for using within a polled Future, but the lock cannot register wakers or automatically park the current thread. A traditional Mutex or the async-mutex crate may be used in this case.

This structure allows for multiple usage patterns. A basic example (in this case an AtomicI32 could be substituted):

use option_lock::OptionLock;

static SHARED: OptionLock<i32> = OptionLock::new(0);

fn try_increase() -> bool {
  if let Some(mut guard) = SHARED.try_lock() {
    let next = guard.take().unwrap() + 1;
    guard.replace(next);
    true
  } else {
    false
  }
}

There are additional examples in the code repository.

This crate uses unsafe code blocks. It is no-std-compatible when compiled without the std feature.

Structs

OnceCell	An Option value which can be safely written once.
OptionGuard	A write guard for the value of an OptionLock
OptionLock	A read/write lock around an Option value.