[Unreal] 언리얼 C++ 기본 타입과 문자열 처리

게임 제작의 특성

데이터의 정보가 명확해야 함

단일 컴퓨터에서 최대 퍼포먼스를 뽑아내야 함

네트워크  상에서 데이터 통신이 효율적이고 안정적이어야 함

 

C++에서  int는 최소 32비트를 보장하도록 규약되어 있음

특정 플랫폼에서는 64비트로 해석될 수 있음

따라서 데이터를 저장할 때 int 타입의 크기 확신 불가

👉 데이터 타입의 애매모호함은 게임 개발시 문제 발생 가능

 

후발언어 C#의 경우, int 타입이 있지만, 4바이트인 int32로 명확히 정의되어 있음

언리얼은 int를 사용하지 않고 int32 사용

 

 

언리얼 엔진의 타입과 크기

 

bool 타입

- 크기가 명확하지 않음

- bit filed 오퍼레이터를 사용하여 데이터 크기를 제한시킬 수 있다.

- bool 타입을 저장할 때, 바이트 타입인 unit8로 선언하되 데이터 크기를 1로 하여 데이터의 양을 최소화 가능

- (저장 한정) 일반 unit8과 구분하기 위해 b 접두사 사용

- (cpp 로직) 자유롭게 bool  사용

unit8 bNetTemp:1;

 

 

char  타입

- 현재 컴퓨터에서 문자열을 처리하는 종류가 다양하다.

- 언리얼에서는 TCHAR 변수 하나로 다 처리 가능

- 언리얼에서는 UTF-16 포맷을 사용. 한 문자당 2바이트

- 텍스트와 관련된 것도 UTF-16 체계를 사용

- 소스코드의 경우엔 많이 사용하는 UTF-8을 사용하여 저장 

- 한글을 사용할 때는 UTF-8 방식으로 저장 cf. 컴파일 문제를 야기할 수 있으니 잘 알고 있으면 사용

 

유니코드를 위한 언리얼 표준 캐릭터 타입 :  TCHAR

문자열은 언제나 TEXT 매크로를 사용해 지정한다.

TEXT매크로를 감싼 문자열은 TCHAR 배열로 지정됨

TCHAR LogCharArray[] = TEXT("Hello Unreal");
UE_LOG(LogTemp, Log, LogCharArray);

 

문자열을 다양하게 사용하고 싶다면, TCHAR 배열이 아닌 언리얼 엔진에서 제공하는 FString 클래스를 사용해야 한다.

FString은 TCHAR 배열을 포함하는 헬퍼 클래스

UE_LOG의 3번째 매개변수는 항상 배열만 들어간다.

FString LogCharString = LogCharArray;
UE_LOG(LogTemp, Log, TEXT("%s"), *LogCharString); //FString이 감싸고 있는 실제 문자열 데이터 가져오기

FString

 

FCString은 FString 내부 클래스. FCString에서 FString 문자열을 변형 (실질적인 일을 담당)

FString은 문자열 저장. 다른 타입으로 변환할 때 포인터를 사용하므로 안전하진 않으므로 주의해야 한다.

 

스크립트에 한글이 있는 경우, vs를 유니코드로 변경하여 저장하여야 한다.

 

const TCHAR* LongCharPtr = *LogCharString; // const의 형태로 참조
TCHAR* LogCharDataPtr = LogCharString.GetCharArray().GetData(); // 수정할 수 있는 데이터

// 배열로 복사
TCHAR LogCharArrayWithSize[100];
FCString::Strcpy(LogCharArrayWithSize, LogCharString.Len(), *LogCharString);

// contains 되어있는지 검사
if (LogCharString.Contains(TEXT("unreal"), ESearchCase::IgnoreCase)) { // 대소문자 구분없이
	int32 Index = LogCharString.Find(TEXT("unreal"), ESearchCase::IgnoreCase);
	FString EndString = LogCharString.Mid(Index);
	UE_LOG(LogTemp, Log, TEXT("Find Test : %s"), *EndString);
}

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

int32 IntValue = 32;
float FloatValue = 3.141592;

FString FloatIntString = FString::Printf(TEXT("Int:%d Float:%f"), IntValue, FloatValue); // 출력
FString FloatString = FString::SanitizeFloat(FloatValue); // float -> FString 형변환
FString IntString = FString::FromInt(IntValue); // int -> FString 형변환

UE_LOG(LogTemp, Log, TEXT("%s"), *FloatIntString);
UE_LOG(LogTemp, Log, TEXT("Int:%s Float:%s"), *IntString, *FloatString);

int32 IntValueFromString = FCString::Atoi(*IntString); // FString -> int
float FloatValueFromString = FCString::Atof(*FloatString); // FString -> float
FString FloatIntString2 = FString::Printf(TEXT("Int:%d Float:%f"), IntValueFromString, FloatValueFromString); // 출력
UE_LOG(LogTemp, Log, TEXT("%s"), *FloatIntString2);

 

 

FString을 FName이나 FText로 변환해서 다양한 용도로 사용 가능

 

FName

에셋 관리를 위해 사용되는 문자열 체계

대소문자 구분없고 수정 불가

가볍고 빠름

문자를 표현하는 용도가 아닌 에셋 키를 지정하는 용도로 사용. 빌드시 해시값으로 변환됨

 

FNamePool이라고 하는 곳에 FName의 <key, value>가 저장되어 있음

문자열을 변환한 해시값 + key가 저장됨

key값을 이용하여 pool에 있는지 유무 검색

문자 정보는 대소문자 구분하지 않고 저장 (ignore case)

결국 FName에는 key값만 들어있기 때문에 용량은 매우 작다. 검색/추가

FName key1(TEXT("PELVIS"));
FName key2(TEXT("pelvis"));
UE_LOG(LogTemp, Log, TEXT("FName 비교 결과 : %s"), key1 == key2 ? TEXT("같음") : TEXT("다름"));

for (int i = 0; i < 100; ++i) {
	FName SearchInNamePool = FName(TEXT("pelvis")); // bad
	const static FName StaticOnlyOnce(TEXT("pelvis")); // good
}

 

FName에 문자열을 대입할 때, 문자열을 키 값으로 변환하고 값이 있는지 검색하는 과정을 거 치기 때문에

빈번히 일어나야  하는 경우에는 오버헤드 발생  가능

👉 이를 위해 미리 한 번만 선언해주거나 const static으로 선언한다.

 

FText

다국어 지원을 하는 문자열 관리 체계