Crate scell

Source
Expand description

The intention of this crate is to allow the use of a Rc<RefCell<T>> throughout code where, after enough testing has been done, the unchecked feature can be enabled, which will convert SCell into a Rc<UnsafeCell<T>>.

SCell provides all of the things that the combination of Rc<RefCell<T>> normally allow and some more, such as implementations for PartialOrd and Ord.

If you plan to do significant testing in debug mode, add the unchecked feature to this crate in release mode. Otherwise, it might be best to enable optimizations in debug so you can test in debug or to create a new profile for testing of optimized binaries that still do the runtime checking that RefCell provides. Once you have performed your testing, use a compile mode with the unchecked feature enabled for this crate and it will remove the overhead from RefCell, but not from Rc since it still needs to know when to drop() the value.

Alternatively, feel free to use this crate for normal use in graphs, meshes, and other recurrent data structures with lots of interconnectivity where the borrow checker simply can’t help. Later, if your code works fine and you need the performance back from RefCell, just use the unchecked feature and your code will be good to go.

Structs§

  • A reference wrapper that lets rust make the same guarentees regardless of internal type
  • A mutable reference wrapper that lets rust make the same guarentees regardless of internal type
  • A smart container for objects in recursive data structures