Struct corundum::prc::VWeak

pub struct VWeak<T: ?Sized, A: MemPool> { /* private fields */ }

VWeak is a version of Prc that holds a non-owning reference to the managed allocation in the volatile heap. The allocation is accessed by calling promote on the VWeak pointer, which returns an Option<Prc<T>>.

Since a VWeak reference does not count towards ownership, it will not prevent the value stored in the allocation from being dropped, and VWeak itself makes no guarantees about the value still being present. Thus it may return None when promoted. Note however that a VWeak reference, unlike Weak, does NOT prevent the allocation itself (the backing store) from being deallocated.

A VWeak pointer is useful for keeping a temporary reference to the persistent allocation managed by Prc without preventing its inner value from being dropped from … It is also used to prevent circular references between Prc pointers, since mutual owning references would never allow either Prc to be dropped. For example, a tree could have strong Prc pointers from parent nodes to children, and Weak pointers from children back to their parents.

The typical way to obtain a VWeak pointer is to call Prc::demote.

Implementations

impl<T: PSafe + ?Sized, A: MemPool> VWeak<T, A>

pub fn null() -> VWeak<T, A> where
    T: Sized, 

pub fn promote(&self, journal: &Journal<A>) -> Option<Prc<T, A>>

Trait Implementations

impl<T: PSafe + ?Sized, A: MemPool> Clone for VWeak<T, A>

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: ?Sized, A: MemPool> Drop for VWeak<T, A>

fn drop(&mut self)

Executes the destructor for this type.

impl<T: ?Sized, A: MemPool> PSafe for VWeak<T, A>

impl<T: ?Sized, A: MemPool> !PSend for VWeak<T, A>

impl<T: ?Sized, A: MemPool> RefUnwindSafe for VWeak<T, A>

impl<T: ?Sized, A: MemPool> !Send for VWeak<T, A>

impl<T: ?Sized, A: MemPool> !Sync for VWeak<T, A>

impl<T: ?Sized, A: MemPool> TxInSafe for VWeak<T, A>

impl<T: ?Sized, A: MemPool> TxOutSafe for VWeak<T, A>

impl<T: ?Sized, A: MemPool> UnwindSafe for VWeak<T, A>