Struct std::sync::Weak [] [src]

pub struct Weak<T> where T: ?Sized {
    _ptr: Shared<ArcInner<T>>,
}

A weak pointer to an Arc.

Weak pointers will not keep the data inside of the Arc alive, and can be used to break cycles between Arc pointers.

Fields

_ptr

Methods

impl<T> Weak<T> where T: ?Sized

fn upgrade(&self) -> Option<Arc<T>>

Upgrades a weak reference to a strong reference.

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

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

Examples

use std::sync::Arc;

let five = Arc::new(5);

let weak_five = Arc::downgrade(&five);

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

impl<T> Weak<T>

fn new() -> Weak<T>

Unstable (downgraded_weak)

: recently added

Constructs a new Weak<T> without an accompanying instance of T.

This allocates memory for T, but does not initialize it. Calling Weak::upgrade() on the return value always gives None.

Examples

#![feature(downgraded_weak)]

use std::sync::Weak;

let empty: Weak<i64> = Weak::new();

Trait Implementations

impl<T> Send for Weak<T> where T: Send + Sync + ?Sized

impl<T> Sync for Weak<T> where T: Send + Sync + ?Sized

impl<T, U> CoerceUnsized<Weak<U>> for Weak<T> where U: ?Sized, T: Unsize<U> + ?Sized

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

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

impl<T> Clone for Weak<T> where T: ?Sized

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

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

impl<T> Drop for Weak<T> where T: ?Sized

fn drop(&mut self)