Struct RcuBox

pub struct RcuBox<T, F = RcuDefaultFlavor> { /* private fields */ }

Defines a RCU-enabled Box.

Limitations

Mutable References

Because there might always be readers borrowing a node’s data, it is impossible to get a mutable references to the data inside the linked list. You should design the type stored in the list with interior mutabillity that can be shared between threads.

Safety

It is safe to send an Arc<RcuBox<T>> to a non-registered RCU thread. A non-registered thread may drop an RcuBox<T> without calling any RCU primitives since lifetime rules prevent any other thread from accessing a RCU reference.

Implementations

impl<T, F> RcuBox<T, F>

where F: RcuFlavor,

pub fn new(data: T) -> Arc<Self>

Creates a new RCU box.

pub fn get<'me, 'guard, G>(&'me self, guard: &'guard G) -> &'guard T

where G: RcuGuard<Flavor = F>, 'me: 'guard,

Returns a immutable reference to the data.

pub fn replace(&self, data: T) -> Ref<T, F>

where T: Send,

Replaces the underlying data atomically.

Trait Implementations

impl<T, F> Drop for RcuBox<T, F>

fn drop(&mut self)

Executes the destructor for this type.

impl<T, F> Send for RcuBox<T, F>

where T: Send,

Safety

An RcuBox can be used to send T to another thread.

impl<T, F> Sync for RcuBox<T, F>

where T: Sync,

Safety

An RcuBox can be used to share T between threads.