UE4随笔：TArray容器

// 声明一个容器，可以不初始化 
TArray<int> arr;
// 使用初始化列表定义 
TArray<int> arr1{ 1,2,3,4,5 };
// 使用Init接口初始化 
TArray<int> arr2;
arr2.Init(666, 5); // 初始化为5个默认值为666的元素 
// 通过初始化列表变量来赋值 
TArray<int> arr3;
arr3 = { 6,7,8,9,10 };

// 适用于基础类型的添加元素 
arr.Add(111);
// 效率更高的添加元素 
arr.Emplace(222);
// 通过右值追加多个元素 
arr.Append({ 333,444,555 });
// 将另一个数组元素追加到当前数组，浅拷贝 
arr.Append(arr2.GetData(), arr1.Num());
// 也可直接传入另一个数组元素变量，浅拷贝 
arr.Append(arr3);
// 往数组中添加唯一元素，如果元素已经存在，则不会添加 
arr.AddUnique(888);
// 之前已添加，下条语句不会增加数组元素 
arr.AddUnique(888);
// 在指定下标处插入新元素 
arr.Insert(123, 0); // 在下标0处插入元素123 
// 另一类在指定下标出插入新元素接口 
arr.EmplaceAt(0, 456); // 在下标0处插入元素456

// 默认排序，按照数据类型的 < 操作符进行排序 
arr.Sort();
// 指定排序规则，一般为一个 lambda 表达式 
arr.Sort([](const int& a, const int& b) {
    return (a > b); // 自定义降序排序 
});

// 获取数组的原始数组首地址，这里相当于获取到了 int[] 类型首地址 
int* pArr = arr.GetData();
// 判断给定下标是否对于容器是否有效，本质即使拿到长度判断下标区间 
bool bIdx = arr.IsValidIndex(100);
// 获取容器当前已存在的元素数量 
unsigned int elementNum = arr.Num();
// 获取元素所代表的类型占用内存大小（字节） 
unsigned int elementSize = arr.GetTypeSize();
// 获取当前容器占用内存总大小，这里并非等于元素数量乘上元素类型内存大小，
// 一般要大于这个值，因为实际获取的是容器在扩容时已经申请的内存大小 
unsigned int totalSize = arr.GetAllocatedSize();
// 查找指定元素，没找到返回 -1 
int index = arr.Find(2333);
// 查找指定元素在容器中是否存在 
bool bContains = arr.Contains(456);
// 依据自定义规则查找元素在容器的存在性，一般是一个 lambda 表达式 
bool bContainCondition = arr.ContainsByPredicate([](const int& num) {
    return (num > 100); // 是否存在大于100的元素 
});

// 下标边界迭代 
for (int idx = 0; idx < arr.Num(); ++idx)
    UE_LOG(LogTemp, Log, TEXT("Pring 1: %d"), arr[idx]);

// C++11新标准元素迭代 
for (auto& num : arr)
    UE_LOG(LogTemp, Log, TEXT("Print 2: %d"), num);
    
// UE4迭代器 
for (auto itr = arr.CreateIterator(); itr; ++itr)
    UE_LOG(LogTemp, Log, TEXT("Print 3: %d"), *itr);

// 赋值操作，浅拷贝 
TArray<int> arr4 = arr2;
arr4[0] = 888; // 不影响 arr2 

// 串联数组，也是浅拷贝，是对 Append 函数的替代，
// 但本质还是通过 Append 配合 MoveTemp 语义操作 
TArray<int> arr5{1,2,3};
arr5 += arr4;
arr5[3] = 999; // 不影响 arr4 

// 同类型数组判等操作，首先判断数组长度是否相等，
// 然后对每个元素，通过其自身重载的 == 和 != 进行比较 
TArray<int> arr6{5,6,7};
TArray<int> arr7{8,9,0};
bool bEqual = (arr6 == arr7); // false 
bool bUnequal = (arr6 != arr7); // true 

// 移动语义，类似标准C++中的 std::move，转移内存所有权 
arr6 = MoveTemp(arr7); // arr6拥有arr7的内存数据，arr7为空

// 如果是移除尾部元素，不会立即析构元素 
arr.RemoveAt(arr.Num() - 1);
// 移除非尾部元素，会立即析构，并且移动其后元素保证内存连续性 
arr.RemoveAt(0);
// 移除指定元素，若移除中间元素会立即析构，移除尾部元素则不会 
// 内部有地址检查，如果传入的是元素本身的引用，会触发断言 
arr.Remove(333);
arr.Remove(arr[5]); // 运行时错误，触发断言 
// 若要使用[]操作符移除指定元素，可使用 RemoveSingle 
arr.RemoveSingle(arr[5]);
// 重设容器容量，如果重设容量小于当前容量，
// 则将多余元素从尾部起移除，移除不会立即析构，离开作用域后析构 
arr.SetNum(7);
// 可自定义规则移除元素，一般为一个 lambda 表达式 
arr.RemoveAll([](const int& num) {
    // 移除元素等于456 的元素，返回true时移除 
    // 移除中间元素时会被立即析构，移除尾部元素则不会 
    return (num == 456);  
});
// RemoveAll容易让人理解为移除全部元素，可以硬编码返回true 
arr.RemoveAll([](const int& num) {
    // 移除所有元素，不会立即析构，离开作用域后析构 
    return true; 
});