[💬] 언리얼 스타일로 코딩해라.

[dd(118.42)]

http://api.unrealengine.com/KOR/Programming/Development/CodingStandard/index.html

위쪽 링크 한 번 쭉 정독하면 좋다.

가독성에 정말 도움되는 팁 몇 가지만 정리해봄.

// 나빠요: // Leaves 증가 ++Leaves; // 좋아요: // 찻잎이 더 있다는 것을 알았습니다. ++Leaves;

자체적으로 설명이 되는 코드를 작성하세요:

// 나빠요: t = s + l - b; // 좋아요: TotalLeaves = SmallLeaves + LargeLeaves - SmallAndLargeLeaves;

나쁜 코드에 코멘트를 달지 마세요 - 그냥 다시 작성하세요:

// 나빠요: // 잎의 총 갯수는 // 작은 잎과 큰 잎을 더한 것에서 // 둘 다인 것을 뺀 것입니다. t = s + l - b; // 좋아요: TotalLeaves = SmallLeaves + LargeLeaves - SmallAndLargeLeaves;

복잡한 표현식은 중간 변수를 사용하여 단순화시키세요. 복잡한 표현식을, 부모 표현식 내에서 그 의미가 잘 설명되도록 이름지은 작은 표현식들을 가진 중간 변수에 할당된 하위 표현식으로 나눌 수 있다면, 이해하기가 수월해질 것입니다. 예를 들어:

if ((Blah->BlahP->WindowExists->Etc && Stuff) && !(bPlayerExists && bGameStarted && bPlayerStillHasPawn && IsTuesday()))) { DoSomething(); }

이런 코드는 다음으로 갈음합니다:

const bool bIsLegalWindow = Blah->BlahP->WindowExists->Etc && Stuff; const bool bIsPlayerDead = bPlayerExists && bGameStarted && bPlayerStillHasPawn && IsTuesday(); if (bIsLegalWindow && !bIsPlayerDead) { DoSomething(); }

값을 반환하는 함수는 반환값에 대한 설명을 해야 합니다. 이름을 통해 함수가 반환하게 될 값을 명확히 알 수 있어야 하지요. 이는 부울 함수의 경우 특히나 중요합니다. 다음 두 예제 메서드를 살펴 봅시다:

bool CheckTea(FTea Tea) {...} // true 면 뭐라는 걸까요? bool IsTeaFresh(FTea Tea) {...} // true 면 차가 신선하다는 것이 명확해집니다.

변수, 메서드, 클래스 이름은 명확하고 애매하지 않으며 서술적이여야 합니다. 이름의 범위가 클 수록, 서술적인 좋은 이름의 중요성 역시 커집니다. 과도한 축약은 피하시기 바랍니다.

예제 float TeaWeight; int32 TeaCount; bool bDoesTeaStink; FName TeaName; FString TeaFriendlyName; UClass* TeaClass; USoundCue* TeaSound; UTexture* TeaTexture;

이것만 지켜도 과거의 자신과 싸울 일이 80%는 줄어듦.

[익명(175.223)]

정작 언리얼 엔진 내부보면 정작지들도 안지켜놓은게 많음ㅋㅋㅋ

[익명(175.223)]

걍 클린 코드 보고 배워라