1. 루프#

TArray<FString> StringArray;
for (const FString& : StringArray)
{
    // 이 루프의 바디는 StringArray를 수정하지 않습니다.
}

2. 포인터 자체에 const#

	// 데이터 수정은 가능하나, 포인터에 증감 연산자 사용은 불가함
    T* const Ptr = ...;
    
    // X 틀림
    T& const Ref = ...;

3. 데이터에 const#

	// X [복사] 나쁜 예 - const 배열 반환 
    const TArray<FString> GetSomeArray();
    
    // [읽기] 좋은 예 - const 배열로의 레퍼런스 반환
    const TArray<FString>& GetSomeArray();
    
    // [읽기] 좋은 예- const 배열로의 포인터 반환
    const TArray<FString>* GetSomeArray();
    
    // X [나쁜 예 - const 배열로의 const 포인터 반환 (포인터/데이터 모두 const)
    const TArray<FString>* const GetSomeArray();

static_assert#

static_assert 키워드는 컴파일 시간 조건 검증을 위해 사용 가능

• 조건이 거짓이면 컴파일 자체를 실패, 잘못된 코드가 실행 파일로 만들어지지 않도록 차단

// 기본 문법
static_assert(조건식, "에러 메시지");

// 1. [타입 크기 검증] 네트워크 패킷은 반드시 64바이트여야 한다
struct FMyPacket
{
    int32 Data[16];
};

static_assert(sizeof(FMyPacket) == 64, "FMyPacket must be 64 bytes!");

// 2. [템플릿 타입 제약]
template<typename T>
void ProcessValue(T Value)
{
    static_assert(std::is_integral<T>::value, "T must be an integral type");
    // 정수형 타입만 허용
}

// 3. [엔진 내부 규칙 강제] UObject 파생 클래스만 허용
template<typename T>
class TMyManager
{
    static_assert(TIsDerivedFrom<T, UObject>::IsDerived, "T must derive from UObject");
};

override & final#

사용을 강력히 권합니다.

nullptr#

C 스타일의 NULL -> nullptr을 사용

auto#

auto는 왠만하면 사용하지 말기

• 변수에 람다 바인딩
• 이터레이터 타입이 장황해 가독성에 악영향을 끼칠때 auto it2 = names.begin();
• (고급 ?) 템플릿 코드에서 표현식의 타입을 쉽게 식별 못할때

범위 기반 for#

사용을 추천합니다.

TMap<FString, int32> MyMap;
    
    // 기존 스타일
    for (auto It = MyMap.CreateIterator(); It; ++It)
    {
        UE_LOG(LogCategory, Log, TEXT("Key: %s, Value: %d"), It.Key(), *It.Value());
    }
    
    // 새 스타일
    for (TPair<FString, int32>& Kvp : MyMap)
    {
        UE_LOG(LogCategory, Log, TEXT("Key: %s, Value: %d"), *Kvp.Key, Kvp.Value);
    }

강 - 타입 Enum#

가능하면 enum class 를 사용

 // 기존 열거형
    UENUM()
    namespace EThing
    {
        enum Type
        {
            Thing1,
            Thing2
        };
    }
    
    // 새 열거형
    UENUM()
    enum class EThing : uint8
    {
        Thing1,
        Thing2
    }

디폴트 멤머 이니셜라이저#

class UTeaOptions : public UObject
{
    GENERATED_BODY()

public:
    UPROPERTY()
    int32 MaximumNumberOfCupsPerDay = 10;   // ← 여기서 바로 초기화
};

위와 같이 바로 초기화 하면, 생성자에서 멤버 초기화가 필요 없다.

• 엔진 코드: 디폴트 멤머 이니셜라이저 자주 사용 X
• 게임 코드: 개발자가 직접 관리하니, 가독성 & 편의성 측면에서 자주 사용 O
• config INI환경설정 파일을 통해 관리 하는것도 권장

물리적 종속성 (Physical Dependencies)#

1. 파일 이름 : 접두사 X UScene.cpp -> Scene.cpp
2. 헤더 관리
   1. 모든 헤더에 #pragma once넣어 중복 include 방지
   2. 헤더가 늘어나면 컴파일 시간이 증가 (가능하면 적게 include)

캡슐화#

가능하면 private으로 선언, getter/setter로 접근

일반적인 스타일 문제#

• 문자열은 꼭 TEXT() 매크로 사용
• 포인터 선언은 무조건 FShaderType* Ptr 구조로
  • Find In Files검색에 용이
• 헤더에 특수한 스태틱 변수 정의 X

// SomeModule.h
static const FString GUsefulNamedString = TEXT("String"); // 각 cpp파일에서 복사본이 생김

// 위 헤더를 참조하는 모든 인스턴스들이 컴파일 됨
// 아래와 같이 개선해야함

// SomeModule.h
extern SOMEMODULE_API const FString GUsefulNamedString; // 링크 단계에서 찾으라고 명시

// SomeModule.cpp
const FString GUsefulNamedString = TEXT("String");

API 디자인 가이드라인#

MakeCupOfTea(Tea, false, true, true);
MakeCupOfTea(Tea, false, true, true, false, true, ...);

enum class ETeaFlags
{
    None,
    Milk  = 0x01,
    Sugar = 0x02,
    Honey = 0x04,
    Lemon = 0x08
};
ENUM_CLASS_FLAGS(ETeaFlags)

FCup* MakeCupOfTea(FTea* Tea, ETeaFlags Flags = ETeaFlags::None);

// 호출 예시
FCup* Cup = MakeCupOfTea(Tea, ETeaFlags::Milk | ETeaFlags::Honey);

// 리플렉션용 껍데기
UINTERFACE(MinimalAPI)
class UDrinkable : public UInterface
{
    GENERATED_BODY()
};

// 실제 인터페이스
class IDrinkable
{
public:
    virtual void Drink() = 0; // 반드시 구현해야 하는 계약
};


// 실제 구현 클래스 UCup
UCLASS()
class UCup : public UObject, public IDrinkable
{
    GENERATED_BODY()

public:
    virtual void Drink() override
    {
        UE_LOG(LogTemp, Log, TEXT("Cup is being drunk!"));
    }
};