Struct WeakRef

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

A weak reference to an object.

Implementations

impl<T: ObjectType> WeakRef<T>

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: ObjectType> Clone for WeakRef<T>

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Debug + ObjectType> Debug for WeakRef<T>

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

Formats the value using the given formatter.

impl<T: ObjectType> Default for WeakRef<T>

fn default() -> Self

Returns the “default value” for a type.

impl<T: ObjectType> Drop for WeakRef<T>

fn drop(&mut self)

Executes the destructor for this type.

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

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

Converts to this type from the input type.

impl<T: ObjectType> PartialEq<T> for WeakRef<T>

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: ObjectType> PartialEq for WeakRef<T>

fn eq(&self, other: &Self) -> 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: ObjectType> PartialOrd for WeakRef<T>

fn partial_cmp(&self, other: &Self) -> 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: IsA<Object> + HasParamSpec> Property for WeakRef<T>

type Value = Option<T>

impl<T: IsA<Object>> PropertyGet for WeakRef<T>

type Value = Option<T>

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

impl<T: IsA<Object>> PropertySet for WeakRef<T>

type SetValue = Option<T>

fn set(&self, v: Self::SetValue)

impl<T: Downgrade + ObjectType> Upgrade for WeakRef<T>

type Strong = T

Strong reference type.

fn upgrade(&self) -> Option<Self::Strong>

Try upgrading a weak reference to a strong reference.

impl<T: ObjectType + Send + Sync> Send for WeakRef<T>

impl<T: ObjectType + Sync> Sync for WeakRef<T>