compact-rc

Crates.iocompact-rc
lib.rscompact-rc
version0.5.5
sourcesrc
created_at2023-05-03 18:20:40.464973
updated_at2024-05-04 18:42:28.999183
descriptionLow-memory reference-counting pointers
homepage
repositoryhttps://github.com/akmizno/compact-rc
max_upload_size
id855686
size75,361
(akmizno)

documentation

README

compact-rc

Low-memory reference-counting pointers.

The types in this crate have almost the same methods as standard Rc and Arc. The differences from the standard type are as follows:

  • Weak reference is not supported.
  • Small integers can be used as refcount.
Crate Strong count Weak count
std usize usize
compact-rc u8, u16, u32, u64, usize not supported

Example

use compact_rc::Rc8;

fn main() {
    // rc1 is a pointer containing i8 value with u8 refcount.
    let rc1: Rc8<i8> = Rc8::new(100);

    assert_eq!(Rc8::strong_count(&rc1), 1);
    assert_eq!(*rc1, 100);

    // Increment the refcount.
    // The value is shared by rc1 and rc2.
    let rc2 = rc1.clone();

    assert_eq!(Rc8::strong_count(&rc1), 2);
    assert_eq!(Rc8::strong_count(&rc2), 2);
    assert_eq!(*rc1, 100);
    assert_eq!(*rc2, 100);
    assert!(Rc8::ptr_eq(&rc1, &rc2));
}
Commit count: 96

cargo fmt