TIL: C++, Unreal Delegate

📅 2026-04-04
주말에도 조금씩은 공부해보려고 한다.

Delegate

Delegate란?

Delegate는 함수를 변수처럼 저장하고 나중에 호출할 수 있게 하는 것

Delegate = 단순 함수 포인터 + 기능 확장

• 여러 함수 등록 가능(이벤트처럼)
• 객체의 멤버 함수도 연결 가능
• 안전하게 호출 가능

"A이벤트 발생 시 B함수 실행해줘"

C++에는 Delegate 키워드로서가 아닌 개념으로 존재
Delegate를 구현하는 다양한 방법 존재

C++ 구현

함수 포인터

void Hello()
{
	std::cout << "Hello";
}

...

int main()
{
	void (*func)() = Hello;
    func();

}

가장 기본이지만 유연성이 없음

std::function

void Hello()
{
	std::cout << "Hello";
}

...

int main()
{
	std::function<void()> func = Hello;

    func();
}	

함수, 람다, 멤버 함수 다 가능
매우 유연함

std::function<void()>
void형식의 파라미터가 없는 함수를 담는 컨테이너를 선언

func = Hello;
func에 Hello 함수의 주소를 저장

Lambda

auto func = []() {
	std::cout << "Lambda";
};

func();

inline delegate 느낌
콜백함수로 많이 사용

Unreal 구현

unreal에서는 Delegate를 이벤트 시스템으로 많이 사용

• Single-cast Delegate

  하나의 함수만 연결

• Multi-cast Delegate

  여러 함수 연결 가능 (이벤트 st)

• Dynamic Delegate

  블루 프린트 연동 가능

Delegate 선언

DECLARE_DELEGATE(FMyDelegate);

함수 바인딩 + 실행

void MyFunction()
{
	UE_LOG(LogTemp, Warning, TEXT("Hello Delegate"));
}

FMyDelegate Delegate;

Delegate.BindStatic(&MyFunction);
Delegate.Execute();

멀티캐스트 Delegate

DECLARE_MULTICAST_DELEGATE(FmyMultiDelegate);

FMyMultiDelegate OnSomething;

void Func1() { ... }
void Func2() { ... }
    
OnSomething.AddStatic(&Func1);
OnSomething.AddStatic(&Func2);
    
OnSomething.Broadcast();

Unreal에서 실제 사용 예시

이벤트 시스템

OnDamaged.Broadcast(NewHealth);

데미지 입을 경우 NewHealth 함수 실행

입력 처리

InputComponent->
BindAction("Jump", IE_Pressed, this, &ACharacter::Jump);

내부적으로 Delegate 사용

InputComponent->
InputComponent의 멤버 접근

BindAction( ... )
함수 호출

내부인자들 ("Jump", IE_Pressed, this, &ACharacter::Jump)
Jump
액션 이름

IE_Pressed
입력 이벤트 타입

• 눌림
• 떼짐
• 반복

this
현재 객체

&ACharacter::Jump();
이 클래스의 Jump 함수 주소

타이머

GetWorld()->GetTimerManager().SetTimer(
	TimerHandle,
    this,
    &AMyActor::MyFunction,
    1.0f,
    false
);

특정 시간 후 함수 호출