Struct bacon_rajan_cc::Weak

pub struct Weak<T: Trace> { /* fields omitted */ }

A weak version of Cc<T>.

Weak references do not count when determining if the inner value should be dropped.

See the module level documentation for more.

Methods

impl<T: Trace> Weak<T>

pub fn upgrade(&self) -> Option<Cc<T>>

Upgrades a weak reference to a strong reference.

Upgrades the Weak<T> reference to an Cc<T>, if possible.

Returns None if there were no strong references and the data was destroyed.

Examples

use bacon_rajan_cc::Cc;

let five = Cc::new(5);

let weak_five = five.downgrade();

let strong_five: Option<Cc<_>> = weak_five.upgrade();

Trait Implementations

impl<T: Trace> Trace for Weak<T>

fn trace(&self, _tracer: &mut Tracer)

Invoke the Tracer on each of the CcBoxPtrs owned by this Trace instance.

impl<T: Trace> Clone for Weak<T>

fn clone(&self) -> Weak<T>

Makes a clone of the Weak<T>.

This increases the weak reference count.

Examples

use bacon_rajan_cc::Cc;

let weak_five = Cc::new(5).downgrade();

weak_five.clone();

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

Performs copy-assignment from source.

impl<T: Trace> Drop for Weak<T>

fn drop(&mut self)

Drops the Weak<T>.

This will decrement the weak reference count.

Examples

use bacon_rajan_cc::Cc;

{
    let five = Cc::new(5);
    let weak_five = five.downgrade();

    // stuff

    drop(weak_five); // explicit drop
}
{
    let five = Cc::new(5);
    let weak_five = five.downgrade();

    // stuff

} // implicit drop

impl<T: Debug + Trace> Debug for Weak<T>

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

Formats the value using the given formatter.