UE_C++ —— Delegates

目录

[一,Declaring Delegates](#一,Declaring Delegates)

[二,Binding Delegates](#二,Binding Delegates)

[Payload Data](#Payload Data)

[三,Executing Delegates](#三,Executing Delegates)

[四,Example Usage](#四,Example Usage)


委托 是一种泛型且类型安全的方式,可在C++对象上调用成员函数;委托可动态绑定到任意对象的成员函数,之后在该对象上调用函数,即使调用者不知对象类型;委托可很安全复制;也可以利用值传递委托,但这样操作需要在堆上分配内存,因此通常并不推荐;请尽量通过引用传递委托;

虚幻引擎共支持三种类型的委托:

  • Single

  • Multicast

  • Dynamic (UObject, serializable)

一,Declaring Delegates

如需声明委托,请使用一下所述的宏;请根据与委托相绑定的函数(或多个函数)的函数签名来选择宏;每个宏都为新的委托类型名称、函数返回类型(如果不是 void 函数)及其参数提供了参数;当前,支持以下使用任意组合的委托签名:

  • 返回一个值的函数;
  • 声明为 函数;
  • 最多4个"载荷"变量;
  • 最多8个函数参数;

|----------------------------------------------|----------------------------------------------------------------------------------------------|
| Function signature | Declaration macro |
| void Function() | DECLARE_DELEGATE(DelegateName) |
| void Function(Param1) | DECLARE_DELEGATE_OneParam(DelegateName, Param1Type) |
| void Function(Param1, Param2) | DECLARE_DELEGATE_TwoParams(DelegateName, Param1Type, Param2Type) |
| void Function(Param1, Param2, ...) | DECLARE_DELEGATE_<Num>Params(DelegateName, Param1Type, Param2Type, ...) |
| <RetValType> Function() | DECLARE_DELEGATE_RetVal(RetValType, DelegateName) |
| <RetValType> Function(Param1) | DECLARE_DELEGATE_RetVal_OneParam(RetValType, DelegateName, Param1Type) |
| <RetValType> Function(Param1, Param2) | DECLARE_DELEGATE_RetVal_TwoParams(RetValType, DelegateName, Param1Type, Param2Type) |
| <RetValType> Function(Param1, Param2, ...) | DECLARE_DELEGATE_RetVal_<Num>Params(RetValType, DelegateName, Param1Type, Param2Type, ...) |

注,委托函数支持与UFunctions相同的说明符,但使用 UDELEGATE 宏而不是 UFUNCTION

cpp 复制代码
UDELEGATE(BlueprintAuthorityOnly)
DECLARE_DYNAMIC_MULTICAST_DELEGATE_FourParams(FInstigatedAnyDamageSignature, float, Damage, const UDamageType*, DamageType, AActor*, DamagedActor, AActor*, DamageCauser);

关于multi-cast, dynamic, and wrapped delegates,上述宏的变体如下:

  • DECLARE_MULTICAST_DELEGATE...
  • DECLARE_DYNAMIC_DELEGATE...
  • DECLARE_DYNAMIC_MULTICAST_DELEGATE...
  • DECLARE_DYNAMIC_DELEGATE...
  • DECLARE_DYNAMIC_MULTICAST_DELEGATE...

委托签名声明可存在于全局范围内、命名空间内、甚至类声明内。此类声明可能不在于函数体内;

二,Binding Delegates

委托系统理解某些类型的对象,使用此类对象时将启用附加功能;将委托绑定到UObject或共享指针类的成员, 委托系统可保留对该对象的弱引用,因此对象在委托下方被销毁时,可通过调用 IsBound() 或 ` ExecuteIfBound()` 函数进行处理;注意各类受支持对象的特殊绑定语法;

|--------------|-------------------------------------------------------------------------------------|
| Function | Description |
| Bind | 绑定到现有委托对象; |
| BindStatic | 绑定原始C++指针全局函数委托; |
| BindRaw | 绑定原始C++指针委托;由于原始指针不使用任何类型的引用,因此在删除目标对象后调用ExecuteExecuteIfBound 会不安全; |
| BindLambda | 绑定一个functor;这通常用于拉姆达函数; |
| BindSP | 绑定基于指针的共享成员函数委托;共享指针委托会保留对对象的弱引用;可使用 ExecuteIfBound() 进行调用; |
| BindUObject | 绑定 UObject 的成员函数委托;UObject 委托会保留对对象 UObject 的弱引用;可使用 ExecuteIfBound() 进行调用; |
| UnBind | 取消绑定此委托; |

可参见 DelegateSignatureImpl.inl(位于 ..\UE4\Engine\Source\Runtime\Core\Public\Templates\),了解此类函数的变体、参数和实现;

Payload Data

绑定到委托时,可同时传递payload数据;其为调用时被直接传到绑定函数的任意变量;此操作十分有用, 利用其可在绑定时将参数存储在委托内;所有委托类型(除"动态"外)均自动支持payload变量;

此范例将两个自定义变量(一个布尔,一个int32)传递到委托;之后调用该委托时, 此类参数将被传到绑定函数;须始终接受委托类型参数后的额外变量参数;

cpp 复制代码
MyDelegate.BindRaw( &MyFunction, true, 20 );

三,Executing Delegates

通过调用委托的 Execute() 函数执行绑定到委托的函数;执行前须检查委托是否已绑定; 此操作是为了使代码更安全,因为有时委托可能含有未初始化且被后续访问的返回值和输出参数; 执行未绑定的委托在某些情况下确实可能导致内存混乱;可调用 IsBound() 检查是否可安全执行委托; 同时,对于无返回值的委托,可调用 ExecuteIfBound(),但需注意输出参数可能未初始化;

|-------------------------|-----------------------------------------------------------------------------|
| Execution Functions | Description |
| Execute | 绑定到现有委托对象; |
| ExecuteIfBound | 绑定原始C++指针全局函数委托; |
| IsBound | 绑定原始C++指针委托;由于原始指针不使用任何类型的引用,因此在删除目标对象后调用ExecuteExecuteIfBound 会不安全; |

四,Example Usage

cpp 复制代码
//假定类拥有可在任何地方随意调用的方法
class FLogWriter
{
	void WriteToLog(FString);
};

要调用 WriteToLog 函数,需创建该函数签名的委托类型;为此,首先需使用以下宏声明委托;

cpp 复制代码
//如一个简单的委托类型
DECLARE_DELEGATE_OneParam(FStringDelegate, FString);

此将创建名为 FStringDelegate 的委托类型,该类型使用 FString 类型的单个参数;

cpp 复制代码
//此为在类中使用此 FStringDelegate 的方法范例
class FMyClass
{
	FStringDelegate WriteToLogDelegate;
};

这允许类保有指向任意类方法的指针;该类唯一真正了解的信息就是,此委托是其函数签名;

如要分配委托,现在只需创建委托类的实例,将拥有该方法的类作为模板参数传递;同时还需传递对象的实例和方法的实际函数地址;

cpp 复制代码
TSharedRef<FLogWriter> LogWriter(new FLogWriter());

WriteToLogDelegate.BindSP(LogWriter, &FLogWriter::WriteToLog);

注:绑定到的对象由共享指针拥有,因此 BindSP 的SP部分代表共享指针;此外, 还有不同对象类型的版本,例如BindRaw()和BindUObject();

FMyClass现在可调用 WriteToLog 方法,甚至无需了解 FLogWriter 类的任何信息!要调用委托,只需使用 Execute() 方法:

cpp 复制代码
WriteToLogDelegate.Execute(TEXT("Delegates are great!"));

如将函数绑定到委托前调用Execute(),将触发断言;多数情况下,建议进行以下操作:

cpp 复制代码
WriteToLogDelegate.ExecuteIfBound(TEXT("Only executes if a function was bound!"));
相关推荐
曦月逸霜8 分钟前
蓝桥杯高频考点——高精度(含C++源码)
c++·算法·蓝桥杯
敲上瘾24 分钟前
高并发内存池(二):Central Cache的实现
linux·服务器·c++·缓存·哈希算法
SNAKEpc121381 小时前
在MFC中使用Qt(五):MFC和Qt的共存和交互
c++·qt·mfc
我们的五年2 小时前
【Linux系统】进程间通信-System V消息队列
linux·运维·服务器·c++
laimaxgg2 小时前
数据结构B树的实现
开发语言·数据结构·c++·b树·算法
mit6.8242 小时前
[Lc6_记忆化搜索] 最长递增子序列 | 矩阵中的最长递增路径
c++·算法·leetcode
双叶8368 小时前
(C语言)虚数运算(结构体教程)(指针解法)(C语言教程)
c语言·开发语言·数据结构·c++·算法·microsoft
牵牛老人11 小时前
C++设计模式-责任链模式:从基本介绍,内部原理、应用场景、使用方法,常见问题和解决方案进行深度解析
c++·设计模式·责任链模式
序属秋秋秋11 小时前
算法基础_基础算法【高精度 + 前缀和 + 差分 + 双指针】
c语言·c++·学习·算法
KeithTsui12 小时前
GCC RISCV 后端 -- 控制流(Control Flow)的一些理解
linux·c语言·开发语言·c++·算法