#rc #arc #integer

compact-rc

Low-memory reference-counting pointers

7 releases

0.5.4 Mar 26, 2024
0.5.2 Jun 4, 2023
0.5.0 May 27, 2023
0.4.2 May 5, 2023
0.3.1 May 3, 2023

#295 in Data structures

Download history 80/week @ 2024-02-10 135/week @ 2024-02-17 100/week @ 2024-02-24 27/week @ 2024-03-02 63/week @ 2024-03-09 83/week @ 2024-03-16 126/week @ 2024-03-23 162/week @ 2024-03-30 274/week @ 2024-04-06

661 downloads per month
Used in 2 crates

MIT/Apache

63KB
2K SLoC

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));
}

No runtime deps