Struct gdnative_core::object::TRef

pub struct TRef<'a, T: GodotObject, Own: Ownership = Shared> { /* private fields */ }

A temporary safe pointer to Godot objects that tracks thread access status. TRef can be coerced into bare references with Deref.

See the type-level documentation on Ref for detailed documentation on the reference system of godot-rust.

Using as method arguments or return values

TRef<T, Shared> can be passed into methods.

Using as owner arguments in NativeScript methods

It’s possible to use TRef as the owner argument in NativeScript methods. This can make passing owner to methods easier.

Implementations

impl<'a, T: GodotObject, Own: Ownership> TRef<'a, T, Own>

pub fn as_ref(self) -> &'a T

Returns the underlying reference without thread access.

pub fn cast<U>(self) -> Option<TRef<'a, U, Own>> where
    U: GodotObject + SubClass<T>, 

Performs a dynamic reference cast to target type, keeping the thread access info.

pub fn upcast<U>(&self) -> TRef<'a, U, Own> where
    U: GodotObject,
    T: SubClass<U>, 

Performs a static reference upcast to a supertype that is guaranteed to be valid, keeping the thread access info.

This is guaranteed to be a no-op at runtime.

pub fn cast_instance<C>(self) -> Option<TInstance<'a, C, Own>> where
    C: NativeClass<Base = T>, 

Convenience method to downcast to TInstance where self is the base object.

impl<'a, Kind, T, Own> TRef<'a, T, Own> where
    Kind: Memory,
    T: GodotObject<Memory = Kind>,
    Own: NonUniqueOwnership, 

pub fn claim(self) -> Ref<T, Own>

Persists this reference into a persistent Ref with the same thread access.

This is only available for non-Unique accesses.

impl<'a, T: GodotObject> TRef<'a, T, Shared>

pub unsafe fn try_from_instance_id(id: i64) -> Option<Self>

Recovers a instance ID previously returned by Object::get_instance_id if the object is still alive.

Safety

During the entirety of 'a, the thread from which try_from_instance_id is called must have exclusive access to the underlying object, if it is still alive.

pub unsafe fn from_instance_id(id: i64) -> Self

Recovers a instance ID previously returned by Object::get_instance_id if the object is still alive, and panics otherwise. This does NOT guarantee that the resulting reference is safe to use.

Panics

Panics if the given id refers to a destroyed object. For a non-panicking version, see try_from_instance_id.

Safety

During the entirety of 'a, the thread from which try_from_instance_id is called must have exclusive access to the underlying object, if it is still alive.

Trait Implementations

impl<'a, T: GodotObject, Own: Ownership> AsRef<T> for TRef<'a, T, Own>

fn as_ref(&self) -> &T

Performs the conversion.

impl<'a, T: GodotObject> AsVariant for TRef<'a, T, Shared>

type Target = T

impl<'a, T: GodotObject, Own: Ownership> Borrow<T> for TRef<'a, T, Own>

fn borrow(&self) -> &T

Immutably borrows from an owned value.

impl<'a, T: GodotObject, Own: Ownership> Clone for TRef<'a, T, Own>

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a, T: GodotObject, Own: Ownership> Debug for TRef<'a, T, Own>

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

Formats the value using the given formatter.

impl<'a, T: GodotObject, Own: Ownership> Deref for TRef<'a, T, Own>

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<'a, T: GodotObject> ToVariant for TRef<'a, T, Shared>

fn to_variant(&self) -> Variant

impl<'a, T, U> AsArg<U> for TRef<'a, T, Shared> where
    T: GodotObject + SubClass<U>,
    U: GodotObject, 

impl<'a, T: GodotObject, Own: Ownership> Copy for TRef<'a, T, Own>

impl<'a, T, Own> OwnerArg<'a, T, Own> for TRef<'a, T, Own> where
    T: GodotObject,
    Own: Ownership + 'static,