Skip to content

finnbear/maybe_atomic_refcell

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.