【UE4 C++】使用自定义的结构体做TMap中的Key

2024-09-06 23:38

本文主要是介绍【UE4 C++】使用自定义的结构体做TMap中的Key,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

使用UE4的TMap

TMap是UE4中一个基础的容器类(在一些其他的场合也叫作“Dictionary”),表明了【键】-【值】一一对应的关系。

比如,我想统计一个场景中每个Actor出现的次数,就可以创建一个Map来存储信息:

TMap<AActor*, int> testMap;

尝试在UE4中使用自定义的结构体作为【键】,编译失败

我自定义的结构体如下:

struct TestStruct
{UObject* ObjA;UObject* ObjB;UObject* ObjC;
};

尝试作为【键】:

TMap<TestStruct, int> testMap;

这样会有报错:

error C2338: TMap must have a hashable KeyType unless a custom key func is provided.

提示需要一个“可哈希”的【键】类型,或者提供自定义的函数。

讨论一个类型作为Map的【键】的条件

抛开UE4,单纯讨论作为一个“Map”(或者说Dictionary),它的【键】的类型有什么条件?

必备:可比较(知道是否是一样的键)

作为【键】的类型,必须是可比较的。这意味,当处理一条“键-值”数据时,必须能知道这条信息中的【键】和现有数据是什么关系,是一个新的【键】吗?还是一个已存在的【键】?如果不能比较,便无法判断了。

加速:可哈希

当数据的条目变得越来越多时,用“逐个比较”的方式来查找一个【键】是否是已存的【键】会变得越来越慢。此时,如果【键】可以哈希为一个序号,则会让查找的操作变得很快。
哈希的原理不必多讲。简单来说:它的内部算法完全没必要研究,只需要知道它的目的就是为了能对相同的输入会输出相同的序号,对不同的输入会输出不同的序号

观察UE4源代码中的使用

我尝试观察UE4的源代码,企图找到一些范例。
我找到了\Engine\Source\Runtime\AssetRegistry\Public\AssetData.h中的FAssetIdentifier

/** A structure defining a thing that can be reference by something else in the asset registry. Represents either a package of a primary asset id */
struct FAssetIdentifier
{/** The name of the package that is depended on, this is always set unless PrimaryAssetType is */FName PackageName;/** The primary asset type, if valid the ObjectName is the PrimaryAssetName */FPrimaryAssetType PrimaryAssetType;/** Specific object within a package. If empty, assumed to be the default asset */FName ObjectName;/** Name of specific value being referenced, if ObjectName specifies a type such as a UStruct */FName ValueName;

对它不必有太深理解,此时只需要知道它在\Engine\Source\Runtime\AssetRegistry\Public\AssetRegistryState.hFAssetRegistryState中有被作为一个TMap的【键】类型:

/** A map of object names to dependency data */
TMap<FAssetIdentifier, FDependsNode*> CachedDependsNodes;

这说明它是一个合法的【键】类型。
观察发现,它重载了==来与其他进行比较,并且实现了哈希的计算方式:

friend inline bool operator==(const FAssetIdentifier& A, const FAssetIdentifier& B)
{return A.PackageName == B.PackageName && A.ObjectName == B.ObjectName && A.ValueName == B.ValueName;
}friend inline uint32 GetTypeHash(const FAssetIdentifier& Key)
{uint32 Hash = 0;// Most of the time only packagename is setif (Key.ObjectName.IsNone() && Key.ValueName.IsNone()){return GetTypeHash(Key.PackageName);}Hash = HashCombine(Hash, GetTypeHash(Key.PackageName));Hash = HashCombine(Hash, GetTypeHash(Key.PrimaryAssetType));Hash = HashCombine(Hash, GetTypeHash(Key.ObjectName));Hash = HashCombine(Hash, GetTypeHash(Key.ValueName));return Hash;
}

可以看到,它比较的方式说白了就是比较所有成员是否相同。而哈希的计算方式就是获得所有成员的哈希,然后使用HashCombine进行结合。

也就是说,只要一个类型的成员都是可哈希的,那么就可以学者类似上面的方法。

在UE4中使用自定义的结构体作为【键】

类似上面的方法,对我自定义的结构体定义operator==GetTypeHash

struct TestStruct
{UObject* ObjA;UObject* ObjB;UObject* ObjC;friend inline bool operator==(const TestStruct& A, const TestStruct& B){return A.ObjA == B.ObjA && A.ObjB == B.ObjB && A.ObjC == B.ObjC;}friend inline uint32 GetTypeHash(const TestStruct& Key){uint32 Hash = 0;Hash = HashCombine(Hash, GetTypeHash(Key.ObjA));Hash = HashCombine(Hash, GetTypeHash(Key.ObjB));Hash = HashCombine(Hash, GetTypeHash(Key.ObjC));return Hash;}
};

这样TMap便可以使用

TMap<TestStruct, int> testMap;

其他延伸

值得留意的是,在开始使用时,我得到了TMap must have a hashable KeyType unless a custom key func is provided这样的信息,这是一个很具提示性的信息。而达成这种提示用了C++一些很复杂的关于“模板”的语法来检查一个类是否有GetTypeHash函数。这个语法未来可以研究一下。

这篇关于【UE4 C++】使用自定义的结构体做TMap中的Key的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1143440

相关文章

Python数据验证神器Pydantic库的使用和实践中的避坑指南

《Python数据验证神器Pydantic库的使用和实践中的避坑指南》Pydantic是一个用于数据验证和设置的库,可以显著简化API接口开发,文章通过一个实际案例,展示了Pydantic如何在生产环... 目录1️⃣ 崩溃时刻:当你的API接口又双叒崩了!2️⃣ 神兵天降:3行代码解决验证难题3️⃣ 深度

Linux内核定时器使用及说明

《Linux内核定时器使用及说明》文章详细介绍了Linux内核定时器的特性、核心数据结构、时间相关转换函数以及操作API,通过示例展示了如何编写和使用定时器,包括按键消抖的应用... 目录1.linux内核定时器特征2.Linux内核定时器核心数据结构3.Linux内核时间相关转换函数4.Linux内核定时

C++ move 的作用详解及陷阱最佳实践

《C++move的作用详解及陷阱最佳实践》文章详细介绍了C++中的`std::move`函数的作用,包括为什么需要它、它的本质、典型使用场景、以及一些常见陷阱和最佳实践,感兴趣的朋友跟随小编一起看... 目录C++ move 的作用详解一、一句话总结二、为什么需要 move?C++98/03 的痛点⚡C++

python中的flask_sqlalchemy的使用及示例详解

《python中的flask_sqlalchemy的使用及示例详解》文章主要介绍了在使用SQLAlchemy创建模型实例时,通过元类动态创建实例的方式,并说明了如何在实例化时执行__init__方法,... 目录@orm.reconstructorSQLAlchemy的回滚关联其他模型数据库基本操作将数据添

Spring配置扩展之JavaConfig的使用小结

《Spring配置扩展之JavaConfig的使用小结》JavaConfig是Spring框架中基于纯Java代码的配置方式,用于替代传统的XML配置,通过注解(如@Bean)定义Spring容器的组... 目录JavaConfig 的概念什么是JavaConfig?为什么使用 JavaConfig?Jav

MySQL快速复制一张表的四种核心方法(包括表结构和数据)

《MySQL快速复制一张表的四种核心方法(包括表结构和数据)》本文详细介绍了四种复制MySQL表(结构+数据)的方法,并对每种方法进行了对比分析,适用于不同场景和数据量的复制需求,特别是针对超大表(1... 目录一、mysql 复制表(结构+数据)的 4 种核心方法(面试结构化回答)方法 1:CREATE

详解C++ 存储二进制数据容器的几种方法

《详解C++存储二进制数据容器的几种方法》本文主要介绍了详解C++存储二进制数据容器,包括std::vector、std::array、std::string、std::bitset和std::ve... 目录1.std::vector<uint8_t>(最常用)特点:适用场景:示例:2.std::arra

C++构造函数中explicit详解

《C++构造函数中explicit详解》explicit关键字用于修饰单参数构造函数或可以看作单参数的构造函数,阻止编译器进行隐式类型转换或拷贝初始化,本文就来介绍explicit的使用,感兴趣的可以... 目录1. 什么是explicit2. 隐式转换的问题3.explicit的使用示例基本用法多参数构造

Java使用Spire.Doc for Java实现Word自动化插入图片

《Java使用Spire.DocforJava实现Word自动化插入图片》在日常工作中,Word文档是不可或缺的工具,而图片作为信息传达的重要载体,其在文档中的插入与布局显得尤为关键,下面我们就来... 目录1. Spire.Doc for Java库介绍与安装2. 使用特定的环绕方式插入图片3. 在指定位

Springboot3 ResponseEntity 完全使用案例

《Springboot3ResponseEntity完全使用案例》ResponseEntity是SpringBoot中控制HTTP响应的核心工具——它能让你精准定义响应状态码、响应头、响应体,相比... 目录Spring Boot 3 ResponseEntity 完全使用教程前置准备1. 项目基础依赖(M