Struct RcuOptionBox 

pub struct RcuOptionBox<T: RcuDroppable + Sync> { /* private fields */ }

An RCU (Read-Copy-Update) wrapper around Option<Box>.

The Box can be dereferenced from multiple threads concurrently without blocking. When the Box is replaced, reads may continue to see the old Box for some period of time.

Implementations

impl<T: RcuDroppable + Sync> RcuOptionBox<T>

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

Create a new RCU Cell from a value.

pub fn read(&self) -> Option<RcuReadGuard<T>>

Read the value of the wrapped Box, if present.

The object referenced by the Box will remain valid until the RcuReadGuard is dropped. However, another thread running concurrently might see a different object.

pub fn as_ref<'a>(&self, scope: &'a RcuReadScope) -> Option<&'a T>

Returns a reference to the value of the wrapped Box, if present.

The object referenced by the Box will remain valid until the RcuReadScope is dropped. However, another thread running concurrently might see a different object.

pub fn is_some(&self, scope: &RcuReadScope) -> bool

Returns true if the RCU wrapper currently contains a value.

pub fn is_none(&self, scope: &RcuReadScope) -> bool

Returns true if the RCU wrapper does not contain a value.

pub fn update(&self, data: Option<T>)

Write a new value to the RCU wrapper.

Concurrent readers may continue to see the old value until the RCU state machine has made sufficient progress to ensure that no concurrent readers are holding read guards.

impl<T: Clone + RcuDroppable + Sync> RcuOptionBox<T>

pub fn cloned(&self) -> Option<T>

Returns a clone of the value of the wrapped Box, if present.

The clone is detached from any RCU read scope.

Trait Implementations

impl<T: Clone + RcuDroppable + Sync> Clone for RcuOptionBox<T>

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Debug + RcuDroppable + Sync> Debug for RcuOptionBox<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<T: RcuDroppable + Sync> Default for RcuOptionBox<T>

fn default() -> Self

Returns the “default value” for a type.

impl<T: RcuDroppable + Sync> Drop for RcuOptionBox<T>

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl<T: RcuDroppable + Sync> From<Option<Box<T>>> for RcuOptionBox<T>

fn from(value: Option<Box<T>>) -> Self

Converts to this type from the input type.

impl<T: RcuDroppable + Sync> RcuDroppable for RcuOptionBox<T>