pub struct ArcRcu<T> { /* private fields */ }
Expand description
A thread-safe reference counted pointer that allows interior mutability
The ArcRcu is functionally roughly equivalent to
Arc<RwLock<T>>
, except that reads (of the old value) may happen
while a write is taking place. Reads on an ArcRcu are much
faster (by a factor of 2 or 3) than reads on either a
Arc<RwLock<T>>
or a Arc<Mutex<T>>
. So in this case you gain
both ergonomics and read speed. Writes are slow, so only use this
type if writes are rare (or their speed doesn’t matter).
let x = rcu_clean::ArcRcu::new(3);
let y: &usize = &(*x);
let z = x.clone();
*x.update() = 7; // Wow, we are mutating something we have borrowed!
assert_eq!(*y, 3); // the old reference is still valid.
assert_eq!(*x, 7); // but the pointer now points to the new value.
assert_eq!(*z, 7); // but the cloned pointer also points to the new value.