Struct UObjectRef 

pub struct UObjectRef<T: UeClass> { /* private fields */ }

A typed, non-owning reference to a UObject.

• Copy + Send — can be freely cloned and sent across threads.
• !Sync — must only be used on the game thread.
• Does not prevent garbage collection; call is_valid before use, or upgrade to Pinned<T> via pin.

Implementations

impl<T: UeClass> UObjectRef<T>

pub unsafe fn from_raw(handle: UObjectHandle) -> Self

Create from a raw FFI handle.

Safety

The caller must ensure the handle points to an object whose UClass is T or a subclass of T.

pub fn raw(&self) -> UObjectHandle

Get the underlying raw handle.

pub fn is_valid(&self) -> bool

Check whether the underlying UObject is still alive.

pub fn checked(&self) -> UikaResult<Checked<T>>

Validate that the object is still alive, returning a Checked<T> handle that provides infallible access to extension trait methods.

pub fn cast<U: UeClass>(self) -> UikaResult<UObjectRef<U>>

Cast to a different UClass type. Fails if the object is destroyed or is not an instance of U.

pub fn pin(self) -> UikaResult<Pinned<T>>

Upgrade to a Pinned<T>, adding a GC root to keep the object alive.

pub fn get_name(&self) -> UikaResult<String>

Get the object’s FName as a String.

pub fn get_class(&self) -> UikaResult<UClassHandle>

Get the object’s UClass handle.

pub fn get_outer(&self) -> UikaResult<UObjectHandle>

Get the object’s Outer.

Trait Implementations

impl<T: Clone + UeClass> Clone for UObjectRef<T>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: UeClass> ContainerElement for UObjectRef<T>

const BUF_SIZE: u32

Buffer size for FFI transport. Must be large enough for the C++ side to write the element value.

unsafe fn read_from_buf(buf: *const u8, _written: u32) -> Self

Interpret bytes from the C++ side into a Rust value.

unsafe fn write_to_buf(&self, buf: *mut u8) -> u32

Write this value into a buffer for C++ WriteElement to consume. Returns the number of bytes written.

const RAW_COPYABLE: bool = false

Whether this type can be bulk-copied as raw bytes (no per-element framing). True for fixed-size primitives (bool, integers, floats) and FName.

impl<T: UeClass> Debug for UObjectRef<T>

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

Formats the value using the given formatter.

impl<T: Hash + UeClass> Hash for UObjectRef<T>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<T: PartialEq + UeClass> PartialEq for UObjectRef<T>

fn eq(&self, other: &UObjectRef<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: UeClass> UeHandle for UObjectRef<T>

fn checked_handle(&self) -> UikaResult<UObjectHandle>

Return the raw handle if the object is alive, or Err(ObjectDestroyed).

fn raw_handle(&self) -> UObjectHandle

Return the raw handle without validity check.

impl<T: Copy + UeClass> Copy for UObjectRef<T>

impl<T: Eq + UeClass> Eq for UObjectRef<T>

impl<T: UeClass> Send for UObjectRef<T>

impl<T: UeClass> StructuralPartialEq for UObjectRef<T>