[comment]: # ($API_Metadata_Start) 다양한 유틸리티를 제공합니다. # Properties

number ElapsedSeconds
현재 월드가 초기화된 이후 흐른 시간을 초 단위로 반환합니다. 서버는 월드가 생성된 시점 이후, 클라이언트는 접속한 시점 이후를 기준으로 시간이 흐른 값입니다.

number ServerElapsedSeconds
서버에서 월드가 생성된 시점 이후 시간이 흐른 값입니다.

# Methods

boolean Contains(string origin, string targetString)
origin 문장에 targetString이 포함되어 있는지 확인합니다.

DateTime GetLocalTimeFrom(DateTime dateTime)
dateTime을 바탕으로 LocalDateTime을 생성해 반환합니다.

string GetUTCNow()
더는 사용하지 않는 함수입니다. DateTime의 UtcNow 프로퍼티를 사용하세요.

string Insert(string origin, int32 insertIndex, string otherString)
origin 문장의 insertIndex 위치에 otherString을 추가합니다.

boolean IsNilorEmptyString(string origin)
origin 문자열이 nil이거나 빈 문자열인지를 판단합니다.

string NewGuid()
새로운 GUID를 생성해 반환합니다. GUID는 하이픈이 없는 32자리 16진수 문자열로 생성됩니다.

number RandomDouble()
0.0부터 1.0 전까지의 임의의 실수를 반환합니다. 1.0은 포함되지 않습니다.

int32 RandomInteger()
음수가 아닌 임의의 정수를 반환합니다. 2147483647 전까지의 정수를 사용합니다.

int32 RandomIntegerRange(int32 min, int32 max)
범위 내의 임의의 정수를 반환합니다. min 값과 max 값이 범위에 포함됩니다.

string Remove(string origin, string targetString)
origin 문장에서 targetString을 찾아서 가장 먼저 발견한 대상을 삭제합니다.

string Replace(string origin, string targetString, string newString)
origin 문장에서 targetString을 찾아서 newString으로 교체합니다.

table<string> Split(string origin, string separator = "", boolean useSeparatorAsOne = true)
origin 문장을 separator를 기준으로 분할합니다.

table StringToTable(string str)
string을 Table 형식으로 변환합니다.

void StringToTable(table table, string str)
string을 Table 형식으로 변환합니다.

string SubString(string origin, int32 startIndex, int32 length = 0)
origin 문장의 startIndex부터 반환합니다.

string TableToString(table table)
Table을 string 형식으로 변환합니다.

string Trim(string origin, string trimString = "")
trimString에 포함된 문자를 앞/뒤에서 제거합니다.

string TrimEnd(string origin, string trimString = "")
trimString에 포함된 문자를 뒤에서 제거합니다.

string TrimStart(string origin, string trimString = "")
trimString에 포함된 문자를 앞에서 제거합니다.

##### inherited from Logic:

EventHandlerBase ConnectEvent(string key, IScriptFunction eventHandler)
이벤트를 연결합니다. 이 서비스에서 타입의 이름이 key인 이벤트가 발생하면, 핸들러로 통지받습니다. 핸들러는 event 매개 변수를 전달받습니다.

EventHandlerBase ConnectEvent(Type eventType, IScriptFunction eventHandler)
이벤트를 연결합니다. 이 서비스에서 타입이 eventType인 이벤트가 발생하면, 핸들러로 통지받습니다. 핸들러는 event 매개 변수를 전달받습니다.

boolean DisconnectEvent(string key, EventHandlerBase eventHandler)
타입의 이름이 key인 이벤트와 핸들러와의 연결을 끊습니다.

boolean DisconnectEvent(Type eventType, EventHandlerBase eventHandler)
타입이 eventType인 이벤트와 핸들러와의 연결을 끊습니다.

boolean IsClient()
현재 실행 환경이 클라이언트인지 아닌지의 여부를 반환합니다.

boolean IsServer()
현재 실행 환경이 서버인지 아닌지의 여부를 반환합니다.

void SendEvent(EventType sendEvent)
이벤트를 발생시킵니다.

# Examples 다음 예시 코드는 각 함수의 반환 값을 보여줍니다. ```lua Method: [client only] void OnBeginPlay () { local utc = _UtilLogic:GetUTCNow() log("GetUTCNow : " .. tostring(utc)) -- MM/dd/yyyy HH:mm:ss.fff local randomInteger = _UtilLogic:RandomInteger() log("RandomInteger : " .. tostring(randomInteger)) -- 0 ~ 2147483646 local randomIntegerRange = _UtilLogic:RandomIntegerRange(1, 5) log("RandomIntegerRange : " .. tostring(randomIntegerRange)) -- 1 ~ 5 local randomDouble = _UtilLogic:RandomDouble() log("RandomDouble : " .. tostring(randomDouble)) -- 0.0 ~ 1.0 local empty = _UtilLogic:IsNilorEmptyString("") log("IsNilorEmptyString : " .. tostring(empty)) -- true local trim = _UtilLogic:Trim("[testString]", "[]") log("Trim : " .. tostring(trim)) -- testString local trimStart = _UtilLogic:TrimStart("[testString]", "[]") log("TrimStart : " .. tostring(trimStart)) -- testString] local trimEnd = _UtilLogic:TrimEnd("[testString]", "[]") log("TrimEnd : " .. tostring(trimEnd)) -- [testString local replace = _UtilLogic:Replace("@!testString@!", "@!", "*") log("Replace : " .. tostring(replace)) -- *testString* local contains = _UtilLogic:Contains("abcdefg", "bcd") log("Contains : " .. tostring(contains)) -- true local split = _UtilLogic:Split("1,2,3,4,5", ",") log("#Split : " .. tostring(#split)) -- 5 local subString = _UtilLogic:SubString("abcdefg", 1, 3) log("SubString : " .. tostring(subString)) -- abc local insert = _UtilLogic:Insert("abcde", 2, "123") log("Insert : " .. tostring(insert)) -- a123bcde local table1 = { "first", "second" } local tableToString = _UtilLogic:TableToString(table1) log("TableToString : " .. tostring(tableToString)) --[[ Int64 1 String first Int64 2 String second --]] local table2 = _UtilLogic:StringToTable(tableToString) for i = 1, #table2 do log(table2[i]) end -- first -- second } ``` 기본 제공 스크립트인 PlayerAttack 스크립트는 RandomDouble() 함수를 사용해 일정 확률로 크리티컬 공격을 발동시킵니다. ```lua Method: boolean CalcCritical (Entity attacker, Entity defender, string attackInfo) { return _UtilLogic:RandomDouble() < 0.3 } ``` # SeeAlso * global [comment]: # ($API_Metadata_End)