2-1. CDO를 덮어주는 값 출력#

MyGameInstance.cpp

#include "MyGameInstance.h"

UMyGameInstance::UMyGameInstance()
{
	SchoolName = TEXT("기본 학교"); // 이 기본값은 CDO 템플릿 객체에 저장
}

void UMyGameInstance::Init()
{
	Super::Init();

	UE_LOG(LogTemp, Log, TEXT("===================="));
	UClass* ClassRuntime = GetClass();
	UClass* ClassCompile = UMyGameInstance::StaticClass();
	UE_LOG(LogTemp, Log, TEXT("학교를 담당하는 클래스 이름 : %s"), *ClassRuntime->GetName());

	SchoolName = TEXT("임의의 학교"); // 현재 인스턴스의 멤버 변수를 덮는다. (CDO로 설정된 초기값이 덮어짐)
	UE_LOG(LogTemp, Log, TEXT("학교 이름 : %s"), *SchoolName);

	UE_LOG(LogTemp, Log, TEXT("===================="));
}

• 위와 같이 SchoolName = TEXT()로 CDO에 저장된 값을 덮어씌우면, 정상적으로 변경된다.

LogTemp: ====================
LogTemp: 학교를 담당하는 클래스 이름 : MyGameInstance
LogTemp: 학교 이름 : 임의의 학교
LogTemp: ====================

2-2. CDO 기본값 출력#

MyGameInstance.cpp

SchoolName = TEXT("임의의 학교");
UE_LOG(LogTemp, Log, TEXT("학교 이름 : %s"), *SchoolName);
UE_LOG(LogTemp, Log, TEXT("학교 이름 기본값 : %s"), *GetClass()->GetDefaultObject<UMyGameInstance>()->SchoolName);

• 이번에는, *GetClass()->GetDefaultObject<UMyGameInstance>()->SchoolName로 CDO 기본값을 출력해보자

LogTemp: ====================
LogTemp: 학교를 담당하는 클래스 이름 : MyGameInstance
LogTemp: 학교 이름 : 임의의 학교
LogTemp: 학교 이름 기본값 : 
LogTemp: ====================

• 위와 같이 기본값이 안나오는데…
• Class Default Object를 고쳐주는 생성자 코드를 변경하는 경우에도 헤더 파일을 고치는 것과 똑같이 에디터를 꺼줘야한다.
  • 헤더 파일의 리플렉션 정보에 구조를 변경
  • 생성자 코드에서 CDO의 기본값을 변경

LogTemp: ====================
LogTemp: 학교를 담당하는 클래스 이름 : MyGameInstance
LogTemp: 학교 이름 : 임의의 학교
LogTemp: 학교 이름 기본값 : 기본 학교
LogTemp: ====================

• 에디터를 다시 실행하면 정상적으로 로그에 찍히는걸 볼 수 있다.

1. 클래스 메타데이터#

• 클래스 이름, 함수 목록, 프로퍼티 목록 등
  • 클래스 자체의 정보

2. CDO (Class Default Object)#

• 기본값을 담은 템플릿 객체
  • 인스턴스 생성 시 초기화 기준으로 사용
  • UClass는 CDO의 포인터를 가지고 있어 런타임에 접근 가능

매크로 분석#

// These macros wrap metadata parsed by the Unreal Header Tool, and are otherwise
// ignored when code containing them is compiled by the C++ compiler
#define UPROPERTY(...)
#define UFUNCTION(...)
#define USTRUCT(...)
#define UMETA(...)
#define UPARAM(...)
#define UENUM(...)
#define UDELEGATE(...)
#define RIGVM_METHOD(...)
#define VMODULE(...)

• 주석 부분
  • 이 매크로들은 Unreal Header Tool (UHT)가 파싱하는 메타데이터를 감싸는 역할을 한다.
  • C++ 컴파일러가 코드를 컴파일할 때는 무시된다.

즉, UPROPERTY()는 C++ 컴파일러 입장에서는 아무 의미 없는 빈 매크로이고, UHT가 소스 코드를 읽을 때만 의미를 가진다.

• 매크로 정의 부분
  • #define UPROPERTY(…)라는 이름의 매크로를 정의했는데, 인자를 받아도 아무 코드로 치환되지 않는다.
  • C++ 컴파일러가 볼 때는 그냥 ‘없음!’ 으로 처리된다.

정리#

• UPROPERTY()는 C++ 컴파일러에는 무시되는 깡통 매크로
• 하지만, UHT (Unreal Header Tool)이 소스 코드를 파싱할 때는 중요한 메타데이터로 인식
  • GC
  • 직렬화
  • 리플렉션
  • 블루프린트 등에 필요한 정보를 생성
• C++ 컴파일러는 위에서 생성된 .generated.h에 메타데이터 코드를 포함해서 컴파일

정의#

• 프로그램이 실행될 때 특정 조건이 참인지 검사하는 함수

목적#

• 잘못된 상태가 발생했을 때 즉시 알려주어 디버깅을 쉽게하고, 치명적인 오류를 방지

종류#

• assert() 표준 C/C++
  • <cassert헤더에 정의됨
  • 조건이 거짓이면 프로그램을 강제 종료하고 오류 메시지를 출력
• Unreal Engine의 check() / ensure()
  • check() : 조건이 거짓이면 즉시 크래시 발생 (개발 중 치명적 오류 확인용)
  • ensure() : 조건이 거짓이면 경고 메시지 출력 후 계속 실행 (비치명적 오류 확인용)

예시#

void UMyGameInstance::Init()
{
    Super::Init();

    // 반드시 SchoolName이 비어있지 않아야 한다고 가정
    check(!SchoolName.IsEmpty()); // 조건이 거짓이면 크래시 발생

    // 혹은 덜 치명적인 경우
    ensure(!SchoolName.IsEmpty()); // 조건이 거짓이면 경고만 띄우고 실행은 계속
}