#debug-mode #debugging #refcell #atomic #run-time #check #unsafe-cell

maybe_atomic_refcell

AtomicRefcell for debug mode and UnsafeCell in release mode

3 unstable releases

0.3.1 May 28, 2022
0.3.0 May 28, 2022
0.2.0 May 28, 2022
0.1.0 May 28, 2022

#18 in #debug-mode

MIT/Apache

12KB
243 lines

maybe_atomic_refcell

AtomicRefCell for debug mode and UnsafeCell in release mode.

Motivation

AtomicRefCell performs an atomic memory access at runtime to validate borrowing. While this is an excellent way to validate code and ensure safety, it is an expensive operation. This crate delegates to AtomicRefCell in debug mode and uses UnsafeCell to emulate the same interface in release mode, minus the runtime overhead.

Features

  • safe enables unconditional runtime checks, good for validating in release mode

Limitations

  • No try-borrows, as they are impossible to (properly) implement without overhead
  • borrow and borrow_mut are unsafe (despite being safe in debug mode)
  • No PartialEq, Eq, PartialOrd, Ord, etc. due to the above

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~20KB