UE5 智能指针完全指南

1
#include "CoreMinimal.h"
2

3
// 创建共享指针
4
TSharedPtr<FVector> Position = MakeShared<FVector>();
5

6
// 使用默认构造
7
TSharedPtr<FVector> Direction = nullptr;
8

9
// 从原始指针创建
10
FVector* RawPtr = new FVector(1, 0, 0);
11
TSharedPtr<FVector> Speed = TSharedPtr<FVector>(RawPtr);
12

13
// 访问内容
14
float X = Position->X;
15
float Y = (*Direction).Y;

1
// 不可为空的共享指针
2
TSharedRef<FVector> Ref = MakeShared<FVector>();
3
Ref->X = 100.f;
4

5
// TSharedRef 可以安全转换为 TSharedPtr
6
TSharedPtr<FVector> Ptr = Ref;

1
// 不增加引用计数的观察者
2
TWeakPtr<FVector> WeakPosition;
3

4
// 从SharedPtr创建
5
TSharedPtr<FVector> Shared = MakeShared<FVector>();
6
TWeakPtr<FVector> Weak = Shared;
7

8
// 检查有效性
9
if (Weak.IsValid())
10
{
11
    // 安全使用
12
    TSharedPtr<FVector> Locked = Weak.Pin();
13
    if (Locked)
14
    {
15
        UE_LOG(LogTemp, Warning, TEXT("X: %f"), Locked->X);
16
    }
17
}

1
TSharedPtr<FVector> Ptr1 = MakeShared<FVector>();
2
// 引用计数 = 1
3

4
TSharedPtr<FVector> Ptr2 = Ptr1;
5
// 引用计数 = 2
6

7
{
8
    TSharedPtr<FVector> Ptr3 = Ptr1;
9
    // 引用计数 = 3
10
}
11
// Ptr3 销毁，引用计数 = 2
12

13
Ptr1.Reset();
14
// 引用计数 = 1
15

16
Ptr2.Reset();
17
// 引用计数 = 0，对象自动销毁

1
// 共享引用计数对象
2
TSharedRef<int32> CountRef = MakeShared<int32>();
3
*CountRef = 0;
4

5
TWeakPtr<int32> Weak = CountRef;
6

7
// 在需要的地方增加引用
8
{
9
    TSharedPtr<int32> Temp = CountRef;
10
    (*CountRef)++;
11
} // Temp 销毁但不影响原引用

1
// TSharedPtr 默认非线程安全
2
TSharedPtr<FVector> ThreadUnsafe;
3

4
// 线程安全版本
5
TSharedPtr<FVector, ESPMode::ThreadSafe> ThreadSafe;
6

7
// 在多线程环境中使用
8
void WorkerThread()
9
{
10
    TSharedPtr<FVector, ESPMode::ThreadSafe> LocalCopy = GlobalPtr;
11
    if (LocalCopy)
12
    {
13
        // 安全访问
14
    }
15
}

1
class UCachedDataManager : public UObject
2
{
3
public:
4
    // 缓存计算结果
5
    TSharedPtr<FVector> GetCachedDirection(FName Key)
6
    {
7
        if (Cache.Contains(Key))
8
        {
9
            return Cache[Key];
10
        }
11

12
        TSharedPtr<FVector> NewData = ComputeDirection(Key);
13
        Cache.Add(Key, NewData);
14
        return NewData;
15
    }
16

17
private:
18
    TMap<FName, TSharedPtr<FVector>> Cache;
19
};

1
class FObserverManager
2
{
3
public:
4
    void Register(TWeakPtr<FSubject> Observer)
5
    {
6
        Observers.Add(Observer);
7
    }
8

9
    void Notify()
10
    {
11
        // 只通知有效且存在的观察者
12
        for (auto It = Observers.CreateIterator(); It; ++It)
13
        {
14
            if (It->IsValid())
15
            {
16
                if (TSharedPtr<FSubject> Observer = It->Pin())
17
                {
18
                    Observer->OnNotify();
19
                }
20
            }
21
            else
22
            {
23
                It.RemoveCurrent();
24
            }
25
        }
26
    }
27

28
private:
29
    TArray<TWeakPtr<FSubject>> Observers;
30
};

1
TSharedPtr<FAsyncLoadTask> LoadAssetAsync(const FSoftObjectPath& Path)
2
{
3
    return TSharedPtr<FAsyncLoadTask>(new FAsyncLoadTask(Path));
4
}
5

6
void OnAssetLoaded(TSharedPtr<FAssetData> Asset)
7
{
8
    if (Asset.IsValid())
9
    {
10
        // 使用加载的资产
11
        ProcessAsset(Asset);
12
    }
13
}

1
// ⚠️ 智能指针不能指向UObject（因为UObject有自己的垃圾回收）
2
// 错误用法
3
TSharedPtr<AActor> Actor = MakeShared<AActor>(); // 编译错误！
4

5
// ✅ 正确做法：使用UObject的垃圾回收
6
TWeakObjectPtr<AActor> ActorPtr;
7

8
// 或使用TScriptInterface
9
TScriptInterface<IActorInterface> ActorInterface;

1
// 用于引用UObject而不影响GC
2
TWeakObjectPtr<AActor> CachedActor;
3

4
// 存储
5
CachedActor = MyActor;
6

7
// 检查有效性
8
if (CachedActor.IsValid())
9
{
10
    AActor* Actor = CachedActor.Get();
11
    // 安全使用
12
}
13

14
// 或使用Pin
15
if (TSharedPtr<AActor> Pinned = CachedActor.Pin())
16
{
17
    // 使用Pinned
18
}