Struct WeakRef

pub struct WeakRef<T>(/* private fields */)
where
    T: ObjectType;

A weak reference to an object.

Implementations

impl<T> WeakRef<T>

where T: ObjectType,

pub fn new() -> WeakRef<T>

Create a new empty weak reference.

upgrade will always return None until an object is set on it.

pub fn set(&self, obj: Option<&T>)

Set this weak reference to the given object.

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

Try to upgrade this weak reference to a strong reference.

If the stored object was already destroyed or no object was set in this weak reference then None is returned.

Trait Implementations

impl<T> Clone for WeakRef<T>

where T: ObjectType,

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T> Debug for WeakRef<T>

where T: Debug + ObjectType,

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

Formats the value using the given formatter.

impl<T> Default for WeakRef<T>

where T: ObjectType,

fn default() -> WeakRef<T>

Returns the “default value” for a type.

impl<T> Drop for WeakRef<T>

where T: ObjectType,

fn drop(&mut self)

Executes the destructor for this type.

impl<T> From<WeakRef<T>> for SendWeakRef<T>

where T: ObjectType,

fn from(v: WeakRef<T>) -> SendWeakRef<T>

Converts to this type from the input type.

impl<T> PartialEq<T> for WeakRef<T>

where T: ObjectType,

fn eq(&self, other: &T) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<T> PartialEq for WeakRef<T>

where T: ObjectType,

fn eq(&self, other: &WeakRef<T>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<T> PartialOrd for WeakRef<T>

where T: ObjectType,

fn partial_cmp(&self, other: &WeakRef<T>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<T> Property for WeakRef<T>

where T: IsA<Object> + HasParamSpec,

type Value = Option<T>

impl<T> PropertyGet for WeakRef<T>

where T: IsA<Object>,

type Value = Option<T>

fn get<R, F>(&self, f: F) -> R

where F: Fn(&<WeakRef<T> as PropertyGet>::Value) -> R,

impl<T> PropertySet for WeakRef<T>

where T: IsA<Object>,

type SetValue = Option<T>

fn set(&self, v: <WeakRef<T> as PropertySet>::SetValue)

impl<T> Upgrade for WeakRef<T>

where T: Downgrade + ObjectType,

type Strong = T

Strong reference type.

fn upgrade(&self) -> Option<<WeakRef<T> as Upgrade>::Strong>

Try upgrading a weak reference to a strong reference.

impl<T> Send for WeakRef<T>

where T: ObjectType + Send + Sync,

impl<T> Sync for WeakRef<T>

where T: ObjectType + Sync,