Unreal Engine 4.26 Documentation

Unreal Engine 4.27 Documentation

Unreal Engine 5.0 Documentation

Unreal Engine 5.1 Documentation

Unreal Engine 5.2 Documentation

Unreal Engine 5.3 Documentation

> Unreal Engine API Reference > Runtime > CoreUObject > UObject > TObjectPtr

Light Theme

Dark Theme

TObjectPtr

[TObjectPtr](API\Runtime\CoreUObject\UObject\TObjectPtr) is a type of pointer to a [UObject](API\Runtime\CoreUObject\UObject\UObject) that is meant to function as a drop-in replacement for raw pointer member properties.

Choose your operating system:

Windows

macOS

Linux

Inheritance Hierarchy

FObjectPtr

TObjectPtr

References

Module	CoreUObject
Header	/Engine/Source/Runtime/CoreUObject/Public/UObject/ObjectPtr.h
Include	#include "UObject/ObjectPtr.h"

Syntax

template<typename T>
struct TObjectPtr : private FObjectPtr

Remarks

TObjectPtr is a type of pointer to a UObject that is meant to function as a drop-in replacement for raw pointer member properties. It is size equivalent to a 64-bit pointer and supports access tracking and optional lazy load behavior in editor builds. It stores either the address to the referenced object or (in editor builds) an index in the object handle table that describes a referenced object that hasn't been loaded yet. It is serialized identically to a raw pointer to a UObject. When resolved, its participation in garbage collection is identical to a raw pointer to a UObject.

This is useful for automatic replacement of raw pointers to support advanced cook-time dependency tracking and editor-time lazy load use cases. See UnrealObjectPtrTool for tooling to automatically replace raw pointer members with FObjectPtr/TObjectPtr members instead.

Constructors

	Name	Description
	TObjectPtr()
	TObjectPtr ( TObjectPtr< T >&& )
	TObjectPtr ( const TObjectPtr< T >& )
	TObjectPtr ( TYPE_OF_NULLPTR )
	TObjectPtr ( const TObjectPtr< U >& Other )
	TObjectPtr ( U&& Object )
	TObjectPtr ( TPrivateObjectPtr< T >&& PrivatePt... )

Functions

		Name	Description
	T *	Get()	: OBJPTR: There is a risk that the FObjectPtr is storing a reference to the wrong type.

Operators

		Name	Description
		operator T *()
		operator T *&()
		operator U *()
		operator UPTRINT()
	bool	operator!= ( const TObjectPtr< U >& Other )
	T &	operator*()
	TObjectPtr< ...	operator= ( TPrivateObjectPtr< T >&& PrivatePt... )
	TObjectPtr< ...	operator= ( U&& Object )
	TObjectPtr< ...	operator= ( const TObjectPtr< U >& Other )
	TObjectPtr< ...	operator= ( TYPE_OF_NULLPTR )
	TObjectPtr< ...	operator= ( const TObjectPtr< T >& )
	TObjectPtr< ...	operator= ( TObjectPtr< T >&& )
	bool	operator== ( const TObjectPtr< U >& Other )
	T *	operator->()

Typedefs

Name	Description
ElementType