언리얼 엔진의 구조체 | 언리얼 엔진 5.5 문서 | Epic Developer Community

• UStruct는 UProperty를 지원하지만 가비지 컬렉션 시스템에 의해 관리되지 않으며 UFunction 함수를 제공할 수 없습니다.

USTRUCT(BlueprintType)   //BlueprintType : 블루프린트와 호환 가능 
struct FMyStruct
{
	GENERATED_BODY()    //이 매크로는 언리얼 오브젝트와 동일함. 이 구조체가 가지고 있는 각종 속성들을 
											//리플렉션을 통해서 활용할 수 있는 기본 뼈대를 제공함. 

	//구조체의 멤버변수에 UPROPERTY 매크로를 추가해주면 
	//리플렉션 기능이 들어가면서 구조체의 멤버변수를 조회하거나, 블루프린트와 연동이 가능해짐. 
	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Test")
	int32 MyIntegerMember;
	
	//UPROPERTY를 안붙이면 C++에서만 사용하는거
	int32 NativeOnlyMember;
	
	//구조체에 이렇게 언리얼 오브젝트 포인터를 선언하게된다면 
	//반드시 UPROPERTY()를 붙여줘야지만 자동으로 메모리 관리를 할 수가 있게됨. 
	UPROPERTY()
	UObject* SafeObjectPointer
}

언리얼 구조체 UStruct 특징

• 데이터 저장/ 전송에 특화된 가벼운 객체임
• 대부분 GENERATED_BODY 매크로를 선언해준다.
  • 리플렌셕, 직렬화와 같은 유용한 기능을 지원함.
  • GENERATED_BODY를 선언한 구조체는 내부적으로는 UScriptStruct라는 클래스로 자동으로 구현됨.
  • (UStruct는 엄밀히 말하면 UScriptStruct 라는 클래스임)
  • 이 경우 제한적으로 리플렉션을 지원함.
    • 속성 UPROPERTY만 선언할 수 있고 함수 UFUNCTION은 선언할 수 없음. (언리얼 오브젝트와 큰 차이점임)
• 언리얼 엔진의 구조체 이름은 F로 시작함.
  • 언리얼엔진이 메모리를 관리해주지 않음.
  • 이유 : 데이터 저장과 전송에 특화된 가벼운 객체로만 사용하기 때문에 굳이 힙의 메모리에 할당할 이유가 없음. 그래서 포인터로 얘를 관리할 이유가 거의 없기 때문에 스택 내 데이터로 그냥 사용되거나 클래스의 멤버변수로 들어가게 되는게 활용방법임.
  • 대부분 힙 메모리 할당(포인터 연산) 없이 스택 내 데이터로 사용됨.
  • NewObjectAPI를 사용할 수 없음.

• UStruct는 UField를 멤버변수로 받아서 컴포지션으로 관리하는 구조를 가짐.
• UStruct를 상속받은 UScriptStruct 클래스가 실질적으로 사용하는 구조체임. (GENERATED_BODY 매크로가 들어간)
• 그리고 UStruct를 상속받으면서 UFunction을 컴포지션으로 가지는게 UClass임. 그래서 클래스는 UFunction을 가질 수 있지만. 구조체는 UPROPERTY만 가질 수 있음.

Student.h

// Fill out your copyright notice in the Description page of Project Settings.

#pragma once

#include "CoreMinimal.h"
#include "UObject/NoExportTypes.h"
#include "Student.generated.h"

/**
 * 
 */
UCLASS()
class UNREALCONTAINER_API UStudent : public UObject
{
	GENERATED_BODY()
	
};