UCommonFunctionLibrary 클래스 참조

#include <UCommonFunctionLibrary.h>

UCommonFunctionLibrary에 대한 상속 다이어그램 :

UCommonFunctionLibrary에 대한 협력 다이어그램:

정적 Public 멤버 함수
static FString	GererateMD5 (const FString &InText)
static float	GetDistance (AActor *A, AActor *B)
	두 액터 사이의 거리를 계산한다.
static int64	GetNowTimestamp ()
	현재 시간을 Unix Timestamp(초)로 반환한다.
static class UMaterialInstanceDynamic *	GetOrCreateMID (class UPrimitiveComponent *Target, int32 ElementIndex, FName OptionalName=NAME_None)
	머티리얼 인스턴스 다이내믹을 얻거나 새로 생성한다.
static int32	GetRandomIndex (const TArray< int32 > &TargetArray, bool &bIsValid)
	정수 배열에서 랜덤 인덱스를 선택한다.
static UAnimMontage *	GetRandomMontage (const TArray< UAnimMontage * > &Montages)
	몽타주 배열에서 랜덤 항목을 반환한다.
static bool	InBounds (const int32 Index, const int32 Count)
	주어진 인덱스가 배열 범위 안에 있는지 확인한다.
static bool	IsValidKoreanWord (const FString &Word)
	한국어 단어 검증 (한글만 포함되어 있는지 확인)
static void	PlayLocationSound (const AActor *Actor, USoundBase *Sound, const float RetriggerDelay)
	지정된 위치에서 사운드를 재생한다.
static FString	RemoveLineBreaks (const FString &InText)
	줄바꿈 문자들을 모두 공백으로 치환한 문자열을 반환
static void	SetCollisionDebugVisible (UPrimitiveComponent *Target, bool bVisible)

상세한 설명

UCommonFunctionLibrary.h 파일의 11 번째 라인에서 정의되었습니다.

멤버 함수 문서화

GererateMD5()

FString UCommonFunctionLibrary::GererateMD5 ( const FString &  InText )

static

UCommonFunctionLibrary.cpp 파일의 56 번째 라인에서 정의되었습니다.

{
    FTCHARToUTF8 UTF8Text(*InText);
 
    uint8 Digest[16];
    FMD5 Md5;
    Md5.Update((uint8*)UTF8Text.Get(), UTF8Text.Length());
    Md5.Final(Digest);
 
    FString HashString;
    for (uint8 B : Digest)
        HashString += FString::Printf(TEXT("%02x"), B);
    return HashString;
}

다음에 의해서 참조됨 : UVoiceCacheManager::GenerateCacheFileName(), APopupTesterActor::GererateMD5().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

GetDistance()

float UCommonFunctionLibrary::GetDistance ( AActor *  A, AActor *  B  )

static

두 액터 사이의 거리를 계산한다.

UCommonFunctionLibrary.cpp 파일의 153 번째 라인에서 정의되었습니다.

{
    if ( !IsValid(A) || !IsValid(B) )
        return 0;
 
    return UKismetMathLibrary::Vector_Distance( A->GetActorLocation(), B->GetActorLocation() );
}

GetNowTimestamp()

int64 UCommonFunctionLibrary::GetNowTimestamp ( )

static

현재 시간을 Unix Timestamp(초)로 반환한다.

UCommonFunctionLibrary.cpp 파일의 97 번째 라인에서 정의되었습니다.

{
    const auto DataTime = FDateTime::UtcNow();
    return DataTime.ToUnixTimestamp();
}

GetOrCreateMID()

UMaterialInstanceDynamic * UCommonFunctionLibrary::GetOrCreateMID ( class UPrimitiveComponent *  Target, int32  ElementIndex, FName  OptionalName = NAME_None  )

static

머티리얼 인스턴스 다이내믹을 얻거나 새로 생성한다.

UCommonFunctionLibrary.cpp 파일의 103 번째 라인에서 정의되었습니다.

{
    if (!Target)
        return nullptr;
 
    const int32 Num = Target->GetNumMaterials();
    if (ElementIndex < 0 || ElementIndex >= Num)
        return nullptr;
 
    UMaterialInterface* CurMat = Target->GetMaterial(ElementIndex);
    if (!CurMat)
        return nullptr;
 
    if (UMaterialInstanceDynamic* AsMID = Cast<UMaterialInstanceDynamic>(CurMat))
        return AsMID;
 
    UMaterialInstanceDynamic* NewMID = UMaterialInstanceDynamic::Create(CurMat, Target, OptionalName);
    if (NewMID)
        Target->SetMaterial(ElementIndex, NewMID);
 
    return NewMID;
}

GetRandomIndex()

int32 UCommonFunctionLibrary::GetRandomIndex ( const TArray< int32 > &  TargetArray, bool &  bIsValid  )

static

정수 배열에서 랜덤 인덱스를 선택한다.

UCommonFunctionLibrary.cpp 파일의 76 번째 라인에서 정의되었습니다.

{
    if (TargetArray.Num() == 0)
    {
        bIsValid = false;
        return INDEX_NONE;
    }
    bIsValid = true;
    return TargetArray[FMath::RandRange(0, TargetArray.Num() - 1)];
}

GetRandomMontage()

UAnimMontage * UCommonFunctionLibrary::GetRandomMontage ( const TArray< UAnimMontage * > &  Montages )

static

몽타주 배열에서 랜덤 항목을 반환한다.

UCommonFunctionLibrary.cpp 파일의 87 번째 라인에서 정의되었습니다.

{
    const int32 Num = Montages.Num();
    if (Num <= 0)
        return nullptr;
 
    const int32 Idx = FMath::RandRange(0, Num - 1);
    return Montages[Idx];
}

InBounds()

bool UCommonFunctionLibrary::InBounds ( const int32  Index, const int32  Count  )

static

주어진 인덱스가 배열 범위 안에 있는지 확인한다.

UCommonFunctionLibrary.cpp 파일의 71 번째 라인에서 정의되었습니다.

{
    return (Index >= 0) && (Index < Count);
}

IsValidKoreanWord()

bool UCommonFunctionLibrary::IsValidKoreanWord ( const FString &  Word )

static

한국어 단어 검증 (한글만 포함되어 있는지 확인)

UCommonFunctionLibrary.cpp 파일의 179 번째 라인에서 정의되었습니다.

{
    if (Word.IsEmpty())
        return false;
 
    // 한글 유니코드 범위 체크
    // - 완성형 한글: AC00-D7A3 (가-힣)
    // - 한글 자음/모음: 1100-11FF, 3130-318F
    for (const TCHAR& Char : Word)
    {
        // 완성형 한글 (가-힣)
        if (Char >= 0xAC00 && Char <= 0xD7A3)
            continue;
        
        // 한글 자음/모음
        if ((Char >= 0x1100 && Char <= 0x11FF) || (Char >= 0x3130 && Char <= 0x318F))
            continue;
 
        // 공백 허용
        if (Char == TEXT(' '))
            continue;
 
        // 한글이 아닌 문자 발견
        return false;
    }
 
    return true;
}

다음에 의해서 참조됨 : UChatInputBox::OnDailyAnswerReceived(), ADailyKiosk::OnResponseDailyQuestion().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

PlayLocationSound()

void UCommonFunctionLibrary::PlayLocationSound ( const AActor *  Actor, USoundBase *  Sound, const float  RetriggerDelay  )

static

지정된 위치에서 사운드를 재생한다.

UCommonFunctionLibrary.cpp 파일의 127 번째 라인에서 정의되었습니다.

{
    if (!IsValid(Actor) || !Sound)
        return;
    
    if (auto World = Actor->GetWorld())
    {
        if ( RetriggerDelay > 0.0f)
        {
            TWeakObjectPtr<const AActor> WeakActor = Actor;
            FTimerHandle TimerHandle;
            World->GetTimerManager().SetTimer(TimerHandle, [WeakActor, Sound]()
            {
                if (WeakActor.IsValid())
                {
                    UGameplayStatics::PlaySoundAtLocation(WeakActor.Get(), Sound, WeakActor->GetActorLocation());
                }
            }, RetriggerDelay, false);
        }
        else
        {
            UGameplayStatics::PlaySoundAtLocation(Actor, Sound, Actor->GetActorLocation());
        }
    }
}

RemoveLineBreaks()

FString UCommonFunctionLibrary::RemoveLineBreaks ( const FString &  InText )

static

줄바꿈 문자들을 모두 공백으로 치환한 문자열을 반환

UCommonFunctionLibrary.cpp 파일의 161 번째 라인에서 정의되었습니다.

{
    FString CleanedText = InText;
    CleanedText.ReplaceInline(TEXT("\r\n"), TEXT(""));
    CleanedText.ReplaceInline(TEXT("\r"), TEXT(""));
    CleanedText.ReplaceInline(TEXT("\n"), TEXT(""));
    return CleanedText;
}

SetCollisionDebugVisible()

void UCommonFunctionLibrary::SetCollisionDebugVisible ( UPrimitiveComponent *  Target, bool  bVisible  )

static

UCommonFunctionLibrary.cpp 파일의 170 번째 라인에서 정의되었습니다.

{
    if (!Target)
        return;
 
    Target->SetHiddenInGame(!bVisible);
    Target->SetVisibility(bVisible);
}

---

이 클래스에 대한 문서화 페이지는 다음의 파일들로부터 생성되었습니다.:

• Source/CoffeeLibrary/Features/Public/UCommonFunctionLibrary.h
• Source/CoffeeLibrary/Features/Private/UCommonFunctionLibrary.cpp