Struct ICoWLock 

pub struct ICoWLock<'lock, ITEM: Debug + Send> { /* private fields */ }

A write-guard which holds new value to which the new values are written. And previous value too. This type of guard is exclusive, so multiple CoW operations CANNOT be performed in parallel which is good for instance update without racing. The readers are also waiting until the changes are commited.

Implementations

impl<'lock, ITEM: Debug + Send> ICoWLock<'lock, ITEM>

pub fn prev_val(&self) -> &ITEM

Returns a reference to previous value. To access modified version use Deref or DerefMut.

pub fn commit(self)

Commits the changes made in the guarded variable.

Returns

Always returns Result::Ok, but the atomic realization would return Result::Err if:

The Result::Err is retruned if race condition happens i.e when updating the inner atomic ptr fails because someone have already changed the value.

pub fn commit_wiht_into_inner(self) -> Arc<ITEM>

Commits the changes made in the guarded variable and returning the atomic reference Arc to previous.

Trait Implementations

impl<'lock, ITEM: Debug + Debug + Send> Debug for ICoWLock<'lock, ITEM>

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

Formats the value using the given formatter.

impl<'lock, ITEM: Debug + Send> Deref for ICoWLock<'lock, ITEM>

type Target = ITEM

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<'lock, ITEM: Debug + Send> DerefMut for ICoWLock<'lock, ITEM>

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.