Struct gdnative_core::object::TRef

pub struct TRef<'a, T: GodotObject, Access: ThreadAccess = Shared> { /* fields omitted */ }

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, Access: ThreadAccess> TRef<'a, T, Access>

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

Returns the underlying reference without thread access.

pub fn cast<U>(self) -> Option<TRef<'a, U, Access>> 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, Access> 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<RefInstance<'a, C, Access>> where
    C: NativeClass<Base = T>, 

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

impl<'a, Kind, T, Access> TRef<'a, T, Access> where
    Kind: RefKind,
    T: GodotObject<RefKind = Kind>,
    Access: NonUniqueThreadAccess, 

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

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

This is only available for non-Unique accesses.

Trait Implementations

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

fn as_arg_ptr(&self) -> *mut godot_object

impl<'a, T: GodotObject, Access: ThreadAccess> AsRef<T> for TRef<'a, T, Access>

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, Access: ThreadAccess> Borrow<T> for TRef<'a, T, Access>

fn borrow(&self) -> &T

Immutably borrows from an owned value.

impl<'a, T: GodotObject, Access: ThreadAccess> Clone for TRef<'a, T, Access>

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, Access: ThreadAccess> Copy for TRef<'a, T, Access>

impl<'a, T: GodotObject, Access: ThreadAccess> Debug for TRef<'a, T, Access>

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

Formats the value using the given formatter.

impl<'a, T: GodotObject, Access: ThreadAccess> Deref for TRef<'a, T, Access>

type Target = T

The resulting type after dereferencing.

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

Dereferences the value.

impl<'a, T, Access> OwnerArg<'a, T, Access> for TRef<'a, T, Access> where
    T: GodotObject,
    Access: ThreadAccess + 'static, 

fn from_safe_ref(owner: TRef<'a, T, Access>) -> Self

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

fn to_variant(&self) -> Variant