Struct Weak

pub struct Weak<T: ?Sized + Trace + 'static> { /* private fields */ }

Available on crate feature weak-ptrs only.

A non-owning pointer to the managed allocation.

Implementations

impl<T: Trace> Weak<T>

pub fn new() -> Self

Constructs a new Weak<T>, without allocating any memory. Calling upgrade on the returned value always gives None.

impl<T: ?Sized + Trace> Weak<T>

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

Tries to upgrade the weak pointer to a Cc, returning None if the allocation has already been deallocated.

This creates a Cc pointer to the managed allocation, increasing the strong reference count.

Panics

Panics if the strong reference count exceeds the maximum supported.

pub fn ptr_eq(this: &Weak<T>, other: &Weak<T>) -> bool

Returns true if the two Weaks point to the same allocation, or if both don’t point to any allocation (because they were created with Weak::new()). This function ignores the metadata of dyn Trait pointers.

pub fn strong_count(&self) -> u32

Returns the number of Ccs to the pointed allocation.

If self was created using Weak::new, this will return 0.

pub fn weak_count(&self) -> u32

Returns the number of Weaks to the pointed allocation.

If self was created using Weak::new, this will return 0.

Trait Implementations

impl<T: ?Sized + Trace> Clone for Weak<T>

fn clone(&self) -> Self

Makes a clone of the Weak pointer.

This creates another Weak pointer to the same allocation, increasing the weak reference count.

Panics

Panics if the weak reference count exceeds the maximum supported.

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

Performs copy-assignment from source.

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

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

Formats the value using the given formatter.

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

fn default() -> Self

Returns the “default value” for a type.

impl<T: ?Sized + Trace> Drop for Weak<T>

fn drop(&mut self)

Executes the destructor for this type.

impl<T: ?Sized + Trace> Finalize for Weak<T>

fn finalize(&self)

The finalizer, which is called after an object becomes garbage and before droping it.

impl<T: ?Sized + Trace> Trace for Weak<T>

fn trace(&self, _: &mut Context<'_>)

Traces the contained Ccs. See Trace for more information.

impl<T, U> CoerceUnsized<Weak<U>> for Weak<T>

where T: ?Sized + Trace + Unsize<U> + 'static, U: ?Sized + Trace + 'static,

Available on crate feature nightly only.