Struct Shared 

pub struct Shared<T> { /* private fields */ }

Single threaded shared value, a thin wrapper over Rc<RefCell<T>>.

Unlike RefCell directly, borrowing never panics: Shared::read and Shared::write return None when the value is already borrowed the other way.

Implementations

impl<T> Shared<T>

pub fn new(data: T) -> Self

Wraps a value into a new shared cell with one reference.

pub fn try_consume(self) -> Result<T, Self>

Unwraps the value when this is the last reference, otherwise gives the handle back untouched.

pub fn read(&self) -> Option<Ref<'_, T>>

Borrows the value immutably, or returns None when it is already borrowed mutably.

pub fn write(&self) -> Option<RefMut<'_, T>>

Borrows the value mutably, or returns None when it is already borrowed.

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

Replaces the value and returns the old one, or None when it is already borrowed.

pub fn references_count(&self) -> usize

Returns how many handles point at this value.

pub fn does_share_reference(&self, other: &Self) -> bool

Returns true when both handles point at the same value.

Trait Implementations

impl<T> Clone for Shared<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: Default> Default for Shared<T>

fn default() -> Shared<T>

Returns the “default value” for a type.