容器是一种类，它的主要功能是存储数据集合。最常见的这些类包括 TArray、TMap 和 TSet。每个类都会自动调节大小，因此增长到您所需的大小。
Containers完整主题：容器API

TArray

在所有三个容器中，在虚幻引擎4中将会使用的主要容器是TArray，它的功能与 std::vector 十分相似，但会提供更多功能。以下是一些常见操作：

  1. TArray<AActor*> ActorArray = GetActorArrayFromSomewhere();
  3. // 告知当前ActorArray中存储了多少个元素（AActor）。
  4. int32 ArraySize = ActorArray.Num();
  6. // TArray基于0（第一个元素将位于索引0处）
  7. int32 Index = 0;
  8. // 尝试检索给定索引处的元素
  9. AActor* FirstActor = ActorArray[Index];
  11. // 在数组末尾添加新元素
  12. AActor* NewActor = GetNewActor();
  13. ActorArray.Add(NewActor);
  15. // 在数组末尾添加元素，但前提必须是该元素尚不存在于数组中
  16. ActorArray.AddUnique(NewActor); // 不会改变数组，因为已经添加了NewActor。
  18. // 从数组中移除"NewActor"的所有实例
  19. ActorArray.Remove(NewActor);
  21. // 移除指定索引处的元素
  22. // 索引之上的元素将下移一位来填充空白空间
  23. ActorArray.RemoveAt(Index);
  25. // 更高效版本的"RemoveAt"，但不能保持元素的顺序
  26. ActorArray.RemoveAtSwap(Index);
  28. // 移除数组中的所有元素
  29. ActorArray.Empty();

TArray 添加了对其元素进行垃圾回收的好处。这样会假设 TArray 存储了 UObject 派生的指针。

  1. UCLASS()
  2. class UMyClass : UObject
  3. {
  4.     GENERATED_BODY();
  6.     // ...
  8.     UPROPERTY()
  9.     AActor* GarbageCollectedActor;
  11.     UPROPERTY()
  12.     TArray<AActor*> GarbageCollectedArray;
  14.     TArray<AActor*> AnotherGarbageCollectedArray;
  15. };

完整主题：TArray
完整主题：TArray API

TMap

TMap 是键-值对的集合，类似于 std::map。TMap 具有一些根据元素键查找、添加和移除元素的快速方法。您可以使用任意类型来表示键，因为它定义有 GetTypeHash 函数，我们稍后将进行介绍。
假设您创建了一个基于网格的棋盘游戏，并需要存储和查询每一个正方形上的内容。TMap 会为您提供一种简单的可用方法。如果棋盘较小，并且尺寸不变，那么或许会有更有效的方法来达到此目的，但在此示例中，我们假设了一个尺寸较大、带有少量棋子的棋盘。

  1. enum class EPieceType
  2. {
  3.     King,
  4.     Queen,
  5.     Rook,
  6.     Bishop,
  7.     Knight,
  8.     Pawn
  9. };
  11. struct FPiece
  12. {
  13.     int32 PlayerId;
  14.     EPieceType Type;
  15.     FIntPoint Position;
  17.     FPiece(int32 InPlayerId, EPieceType InType, FIntVector InPosition) :
  18.         PlayerId(InPlayerId),
  19.         Type(InType),
  20.         Position(InPosition)
  21.     {
  22.     }
  23. };
  25. class FBoard
  26. {
  27. private:
  29.     // 通过使用TMap，我们可以按位置引用每一块
  30.     TMap<FIntPoint, FPiece> Data;
  32. public:
  33.     bool HasPieceAtPosition(FIntPoint Position)
  34.     {
  35.         return Data.Contains(Position);
  36.     }
  37.     FPiece GetPieceAtPosition(FIntPoint Position)
  38.     {
  39.         return Data[Position];
  40.     }
  42.     void AddNewPiece(int32 PlayerId, EPieceType Type, FIntPoint Position)
  43.     {
  44.         FPiece NewPiece(PlayerId, Type, Position);
  45.         Data.Add(Position, NewPiece);
  46.     }

完整主题：TMap
完整主题：TMap API

TSet

TSet 存储唯一值集合，类似于 std::set。虽然通过 TArray 可通过其 AddUnique 和 Contains 方法支持类似集的行为，TSet 可以更快的实现这些运算且不会自动添加非独有元素。

  1. TSet<AActor*> ActorSet = GetActorSetFromSomewhere();
  3. int32 Size = ActorSet.Num();
  5. // 向集添加元素，但前提是集尚未包含这个元素
  6. AActor* NewActor = GetNewActor();
  7. ActorSet.Add(NewActor);
  9. // 检查元素是否已经包含在集中
  10. if (ActorSet.Contains(NewActor))
  11. {
  12.     // ...
  13. }
  15. // 从集移除元素
  16. ActorSet.Remove(NewActor);
  18. // 从集移除所有元素
  19. ActorSet.Empty();
  21. // 创建包含TSet元素的TArray
  22. TArray<AActor*> ActorArrayFromSet = ActorSet.Array();