[UE5] #03 언리얼 엔진의 C++ 기본 타입과 문자열 알아보기!

결과물

 

1. 언리얼 C++ 기본 타입

https://docs.unrealengine.com/5.2/ko/epic-cplusplus-coding-standard-for-unreal-engine/

📌 언리얼이 기본 타입을 따로 지정하는 이유
플랫폼에 따라서 C++ 기본 타입의 크기가 달라지는 경우가 있다. 예를 들어 64bit window에서는 long이 4byte인데 반해, 64bit linux에서는 long이 8byte로 해석된다. 이런 데이터 타입의 모호함은 게임 개발 시에 문제가 생길 수 있다.

• bool- 부울 값(부울 크기 추정 금지).BOOL은 컴파일 되지 않습니다.
• TCHAR- character(문자) (TCHAR 크기 추정 금지)
• uint8- unsigned byte(부호 없는 바이트) (1바이트)
• int8- signed byte(부호 있는 바이트) (1바이트)
• uint16- unsigned 'shorts'(부호 없는 'short') (2바이트)
• int16- signed 'short'(부호 있는 'short')(2바이트)
• uint32- unsigned int(부호 없는 int) (4바이트)
• int32- signed int(부호 있는 int) (4바이트)
• uint64- unsigned 'quad word'(부호 없는 '쿼드 단어') (8바이트)
• int64- signed 'quad word'(부호 있는 '쿼드 단어') (8바이트)
• float- 단정밀도 부동 소수점(4바이트)
• double- 배정밀도 부동 소수점(8바이트)
• PTRINT- 포인터를 가질 수 있는 정수(PTRINT 크기 추정 금지)

bool 타입

bool은 크기가 명확하지 않다. 따라서 가급적 헤더에서는 uint8을 사용하되 Bit Field 오퍼레이터를 사용하여 데이터 크기를 제한해야 한다. 이때 일반 uint8과 분하기 위해 접두사 b를 사용한다.

(헤더가 아닌 cpp 로직에서는 bool 사용해도 괜찮다.)

uint8 bNetTemporary:1;

 

2. TCHAR와 FString

	TCHAR LogCharArray[14] = TEXT("Hello Unreal!");
	UE_LOG(LogTemp, Log, TEXT("%s"), LogCharArray);
 
	FString LogCharString = LogCharArray;
	UE_LOG(LogTemp, Log, TEXT("%s"), *LogCharString); // FString의 TChar 포인터를 얻으려면 포인터 연산자(*) 사용.

• TCHAR : UTF-16를 위한 언리얼 표준 캐릭터 타입
• FString :문자열을 다루는 클래스. FString은 TCHAR 배열을 포함하는 헬퍼 클래스

FString 구조

• TCHAR 배열을 FString에 넣으면 TCHAR 동적배열(TArray)로 전환되어 저장된다.
• FString에 *연산자를 사용하면 FString TCHAR 동적 배열의 첫번째 주소가 반환된다.
• FString 내부에 있는 FCString 클래스는 C에서 제공해주는 문자 함수들을 담고 있는 래퍼(wrapper) 클래스
• FString의 유용한 함수 몇 가지
  • FString::Printf ⇒ string 출력
  • FString::SanitizeFloat ⇒ float to string
  • FString::FromInt ⇒ int to string
• FCString의 유용한 함수 몇 가지
  • FCString::Atoi ⇒ string to int
  • FCString::Atof ⇒ string to float

FString 활용

1. FString에서 TCHAR 배열 읽는 방법

// FString에서 TCHAR 배열 읽는 방법
	// 1. const TCHAR* 로 읽기
	const TCHAR* LogCharPtr = *LogCharString;
	// 2. TCHAR* 로 읽기
	TCHAR* LogCharDataPtr = LogCharString.GetCharArray().GetData();
	// 3. TCHAR 배열로 읽기
	TCHAR LogCharArrayWithSize[100];
	FCString::Strcpy(LogCharArrayWithSize, LogCharString.Len(), *LogCharString);

2. FString에서 특정 문자열 찾기

// FString에서 문자열 찾기
	if (LogCharString.Contains(TEXT("unreal"), ESearchCase::IgnoreCase))
	{
		// FString에서 문자열을 찾고 시작 위치 받기
		int32 Index = LogCharString.Find(TEXT("unreal"), ESearchCase::IgnoreCase);
		// Index ~ 끝까지 문자열 자르기
		FString EndString = LogCharString.Mid(Index);
		// 로그로 출력
		UE_LOG(LogTemp, Log, TEXT("Find Test: %s"), *EndString);
	}

• ESearchCase : 문자열 검색 옵션
  • ESearchCase::CaseSensitive ⇒ 대소문자 구별하여 문자열 찾기
  • ESearchCase::IgnoreCase ⇒ 대소문자 구별 없이 문자열 찾기

3. FString 나누기

// FString 나누기
	FString Left, Right;
	if (LogCharString.Split(TEXT(" "), &Left, &Right))
	{
		UE_LOG(LogTemp, Log, TEXT("Split Test: %s 와 %s"), *Left, *Right);
	}

이전에 언급한 것처럼 소스 코드에서 한글을 사용하려면 파일을 UTF-8 인코딩 방식으로 저장해야 한다.

4. int, float ↔ FString 

	int32 IntValue   = 32;
	float FloatValue = 3.141592;
 
	FString FloatIntString = FString::Printf(TEXT("INT: %d , FLOAT: %f"), IntValue, FloatValue);
	UE_LOG(LogTemp, Log, TEXT("%s"), *FloatIntString);
 
	// Int to FString & Float to FString 
	FString FloatString    = FString::SanitizeFloat(FloatValue);
	FString IntString      = FString::FromInt(IntValue);
 
	UE_LOG(LogTemp, Log, TEXT("INT: %s , FLOAT: %s"), *IntString, *FloatString);
 
	// FString to Int & FString to Float
	int32 IntValueFromString   = FCString::Atoi(*IntString);
	float FloatValueFromString = FCString::Atof(*FloatString);
	FloatIntString             = FString::Printf(TEXT("INT: %d , FLOAT: %f"), IntValueFromString, FloatValueFromString);
	UE_LOG(LogTemp, Log, TEXT("%s"), *FloatIntString);

 

3. 언리얼이 제공하는 다양한 문자열 처리

3-1. FName : Asset 관리를 위해 사용되는 문자열 체계

https://docs.unrealengine.com/5.2/ko/fname-in-unreal-engine/

• string을 hash값으로 전환하여 빠르게 원하는 에셋을 찾을 수 있게 한다.
• 문자를 표현하는 용도가 아닌 애셋 키를 지정하는 용도로 사용. 빌드시 해시값으로 변환된다.

구조

• 언리얼에는 FName을 관리하기 위한 싱글톤 형태의 글로벌 FNamePool을 가지고 있다.
• FNamePool에 FName이 Key-Value 형태로 저장되어 있다.
  • Key : FName의 해시값
  • Value : uint32

특징

• 대소문자 구분 없음
• 한번 선언되면 바꿀 수 없음
• 가볍고 빠름

주의할 점

• FName을 새로 생성하면, 문자열을 해시값으로 변환한 다음에 FNamePool 겹치는 해시값이 있는지 비교하는 과정이 일어난다. ⇒ 매 프레임 FName 추가시 오버헤드 발생할 수 있다.
• 따라서 매 프레임 실행되는 코드에 FName을 생성하는 코드가 불가피하게 들어간다면 아래와 같이 추가하자.

// static이라 한번 초기화 된 이후에 다시 초기화 되지 않는다.게다가 const라 변경될 일도 없다.
const static FName StaticOnlyOnce(TEXT("pelvis"));

3-2. FText : 다국어 지원을 위한 문자열 관리 체계

• 일종의 키로 작동한다.
• 별도의 문자열 테이블 정보가 추가로 요구된다.
• 게임 빌드 시 자동으로 국가별 언어로 전환된다.

강의 : 이득우 언리얼 프로그래밍 강좌