Lua Globals

사용되지 않는 항목 표시

*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.

다음은 Lua의 기능 및 변수의 목록입니다. 이러한 함수는 Lua 5.1.4의 표준 설치에서 사용할 수 있지만, Roblox에서 일부는 작동하는 방법에 대해 약간의 차이가 있습니다.

요약

함수

  • assert(value : Variant,errorMessage : string):Variant

    제공된 valuefalse 또는 nil 으로 해결되면 오류가 발생합니다.

  • error(message : string,level : number):void

    스레드 실행을 중지하고 오류를 발생시킵니다.

  • 킬로바이트당 메모리 힙 크기를 반환합니다.

  • getmetatable(t : Variant):Variant

    지정된 테이블의 메타테이블을 반환합니다.

  • 반복 문 함수와 테이블을 반환합니다.Returns an iterator function and the table for use in a for loop.

  • loadstring(contents : string,chunkname : string):Variant

    제공된 코드를 실행할 수 있는 함수로 반환합니다.

  • newproxy(addMetatable : bool):userdata

    옵션 메타테이블을 포함하여 빈 userdata 를 만듭니다.

  • next(t : table,lastKey : Variant):Variant,Variant

    루프에서 사용할 반복 기능 함수입니다.

  • 반복 문 for 에서 사용할 테이블을 반환합니다.

  • pcall(func : function,args : Tuple):bool,Variant

    제공된 함수를 실행하고 발생하는 모든 오류를 캐치하고 함수의 성공과 결과를 반환합니다.

  • print(params : Tuple):void

    제공된 모든 값을 출력에 프린트합니다.

  • rawequal(v1 : Variant,v2 : Variant):bool

    메타메서드를 우회하여 v1v2 와 같은지 여부를 반환합니다.

  • rawget(t : table,index : Variant):Variant

    모든 메타메서드를 무시하고 table[index] 의 실제 값을 얻습니다.

  • 메타메서드를 무시하고 문자열 또는 테이블의 길이를 반환합니다.

  • rawset(t : table,index : Variant,value : Variant):table

    메타메서드를 무시하고 table[index] 의 실제 값을 설정합니다.

  • require(module : ModuleScript):Variant

    ModuleScript가 실행되지 않았다면 반환하는 값을 반환합니다.

  • select(index : Variant,args : Tuple):Tuple

    지정된 인덱스 후에 모든 인수를 반환합니다.

  • setmetatable(t : table,newMeta : Variant):table

    지정된 테이블의 메타테이블을 설정합니다.

  • tonumber(arg : Variant,base : number):Variant

    불가능한 경우 제공된 값을 숫자로 변환하거나 없으면 제공된 값을 없습니다.

  • tostring(e : Variant):string

    가능하지 않은 경우 제공된 값을 문자열 또는 없으면 반환됩니다.

  • type(v : Variant):string

    제공되는 개체의 기본 유형을 반환합니다.

  • unpack(list : table,i : number,j : number):Variant

    지정된 목록의 모든 요소를 튜플로 반환합니다.

  • xpcall(f : function,err : function,args : Tuple):bool,Variant

    Global.LuaGlobals.pcall() 에 유사하지만 사용자 정의 오류 처리기를 사용합니다.

속성

  • 같은 컨텍스트 레벨모든 스크립트 간에 공유되는 테이블입니다.

  • 현재 해석기 버전을 포함하는 글로벌 변수입니다.

함수

assert

Variant

제공된 valuefalse 또는 nil 인 경우 오류가 발생합니다. 주장이 성공하면 전달된 모든 값을 반환합니다.


local product = 90 * 4
assert(product == 360, "Oh dear, multiplication is broken")
-- The line above does nothing, because 90 times 4 is 360

매개 변수

value: Variant

대상이 되는 값입니다.

errorMessage: string

부정 식이 실패하면 표시되는 텍스트.The text that will be shown in the error if theassertion fails.

기본값: assertion failed!

반환

Variant

error

void

마지막으로 호출된 보호된 함수를 영구 정지message 를 오류 메시지로 출력합니다. 오류가 있는 함수가 보호된 함수에 호출되지 않았다면 함수를 호출한 스크립트는 모두 종료됩니다. 오류 함수 자체는 종료되지 않고 스크립트 오류처럼 작동합니다.

level 인수는 오류 위치를 가져오는 방법을 지정합니다. 기본 레벨 1 (오류 함수가 호출된 위치)에 대해 오류 위치는 오류 함수가 호출된 위치입니다. 레벨 2는 메시지오류를 호출한 위치를 지정하고, 그런 다음 레벨 1

매개 변수

message: string

표시할 오류 메시지입니다.

level: number

인쇄할 정보 수준. 기본값은 1입니다.

기본값: 1

반환

void

gcinfo

메모리 힙 크기를 킬로바이트 단위로 반환합니다. 숫자는 가비지 수집기가 개체를 해제할 때 현재 메모리 힙 사용량을 반영하므로 시간이 지남에 따라 변경됩니다.

반환

getmetatable

Variant

지정된 테이블의 메타테이블을 반환합니다 t 하나가 있는 경우, 그렇지 않으면 일반 반환 하 고 메타메서드 는 t 설정 되 면 해당 값을 반환 합니다.


-- getmetitable 을 시연합니다.
local meta = {}
local t = setmetatable({}, meta)
print(getmetatable(t) == meta) --> 예
-- __metable 메타메서드를 설정하여 원래 메타테이블을 복구 불가능하게 만듭니다.
meta.__metatable = "protected"
print(getmetatable(t)) --> protected

매개 변수

t: Variant

메이널 테이블을 가져올 개체입니다.

반환

Variant

ipairs

반복기 함수, 테이블 t 및 숫자 0 를 반환합니다. 반복기 함수가 호출될 때마다 테이블에서 다음 숫자 인덱스 값 쌍을 반환합니다. 제네릭 반복 루프에서 사용할 때 반환 값을 반복할 수 있습니다:


local fruits = {"apples", "oranges", "kiwi"}
for index, fruit in ipairs(fruits) do
print(index, fruit) --> 1개의 사과, 2개의 오렌지, 3개의 키위 등...
end

매개 변수

반복해야 하는 요소가 있는 테이블.

loadstring

Variant

문자열에서 Lua 코드를 로드하고 함수로 반환합니다.

일반 Lua 5.1과 달리 Roblox의 Lua는 loadstring() 를 사용하여 바이너리 버전의 Lua를 로드할 수 없습니다.

loadstring()은 기본적으로 비활성화되어 있습니다. 활성화 방법에 대한 지침은 ServerScriptService를 참조하십시오.

경고: 이 메서드는 반환된 함수에서 일부 Luau 최적화를 비활성화합니다. 사용자가 경험에서 코드를 실행할 수 있도록 허용하려면 loadstring() 를 사용하는 경우

매개 변수

contents: string

Lua 코드로 로드할 지정된 문자열입니다.

chunkname: string

오류 메시지 및 디버그 정보에 대한 옵션 Chunk 이름입니다. 지정되지 않으면 Lua는 contents 문자열을 사용합니다.

반환

Variant

newproxy

옵션 메타테이블을 포함하여 빈 userdata 를 만듭니다.

매개 변수

addMetatable: bool
기본값: false

반환

반환 식 함수, 전달된 테이블 t , 그리고 nil , 즉 건설이 해당 테이블의 모든 키/값 쌍을 반복하도록 해 주 디 건설 일반적인 for 루프에서 사용되는 경우 건설이 반복됩니다:


local scores = {
["John"] = 5,
["Sally"] = 10
}
for name, score in pairs(scores) do
print(name .. " has score: " .. score)
end

매개 변수

반복할 배열 또는 사전 테이블.

pcall

pcall() 함수를 보호된 모드에서 지정된 코드호출합니다. 즉, func 내의 모든 오류가 전파되지 않고, 대신 pcall()

매개 변수

func: function

보호 모드에서 호출할 함수입니다.

args: Tuple

실행 시 func에 보내는 인수.

반환

Variant

print

void

모든 수의 인수를 받고 출력에 값을 출력합니다. print 은 형식화된 출력을 위한 것이 아니라 단지 값을 표시하는 빠른 방법을 위한 것입니다, 일반적으로 디버

매개 변수

params: Tuple

출력할 모든 인수 값.

반환

void

rawequal

메타메서드를 호출하지 않고 v1v2 와 같은지 여부를 확인합니다.

매개 변수

v1: Variant

비교할 첫 번째 변수입니다.

v2: Variant

비교할 두 번째 변수.

반환

rawget

Variant

메타메서드를 호출하지 않고 table[index] 의 실제 값을 가져옵니다.

매개 변수

참조할 테이블입니다.

index: Variant

t 에서 가져오는 인덱스입니다.

반환

Variant

rawlen

메타메서드를 호출하지 않고 문자열 또는 테이블의 길이를 반환합니다.

매개 변수

참조할 테이블입니다.

반환

rawset

메타메서드를 호출하지 않고 table[index] 의 실제 값을 value 로 설정합니다.

매개 변수

참조할 테이블입니다.

index: Variant

t 에 지정된 value 에 설정하는 인덱스를 반환합니다. 0과 다를 수 없습니다.

value: Variant

테이블에 지정된 값을 index 에 설정하는 값입니다.

반환

require

Variant

제공된 ModuleScript 을 실행하고 제공된 ModuleScript

위에서 설명한 대로 "개체 공유" 동작은

또한 사용자가 원하는 ModuleScript 가 Roblox에 업로드되었으면 Roblox(MainModule라는 인스턴스 이름)에서 require() 함수를 사용하여 자산 ID의 2>Class.ModuleScript2> 에서 로드할 수 있지만, 서버에서만

매개 변수

module: ModuleScript

Class.ModuleScript 이 제공하는 반환 값을 검색하도록 실행될 예정입니다.

반환

Variant

Class.ModuleScript 반환(일반적으로 테이블 또는 함수)

select

인수 번호 index 후에 모든 인수를 반환합니다. 부정적인 경우 인수 목록의 끝에서 반환됩니다.


print(select(2, "A", "B", "C")) --> B C
print(select(-1, "A", "B", "C")) --> C

index 인수가 "#" 이 되면 반환 후 패스된 인수의 수입니다.


print(select("#", "A", "B", "C")) --> 3

매개 변수

index: Variant

# 이후에 모든 인수를 반환하는 인덱스입니다. 이 인수가 설정된 경우 "#" 이후에 패스된 인수의 수입니다.

args: Tuple

인수 집합.

반환

setmetatable

지정된 테이블에 대한 메타테이블을 t로 설정합니다. 만약 newMeta가 0이면 newMeta의 메타테이블이 제거됩니다. 마지막


local meta = {__metatable = "protected"}
local t = {}
setmetatable(t, meta) -- 이렇게 하면 t의 메타테이블이 설정됩니다.
-- 이제 테이블, t, 메타테이블이 있습니다. 만약 우리가 그것을 변경하려고 한다면...
setmetatable(t, {}) --> Error: cannot change a protected metatable

매개 변수

메타테이블을 설정하는 테이블.

newMeta: Variant

일치하는 테이블 메타테이블을 제거하면 됩니다. 그렇지 않으면 지정된 테이블의 메타테이블을 설정합니다.

반환

tonumber

Variant

지정된 기반으로 숫자로 변환하려는 시도는 해석할 값을 반환하지 못하는 경우가 있습니다. 변환할 수 없으면 이 함수는 null을 반환합니다.

기본 값은 2에서 36 사이의 모든 정수입니다. 기본 값은 10 이상의 경우 문자 'A' (위쪽 또는 아래쪽 케이스)가 10을 나타내고, 나머지는 'B'가 나타냅니다. 기타 값은 'Z'가 35를 나타냅니다. 기본 값에는 소수 부분

기본 문자열이 0x 와 시작하고 기본 베이스가 제공되지 않으면 0x 이 잘리고 기본 베이스가 16개 또는 16진수로 나눔을 가정합니다.


print(tonumber("1337")) --> 1337(기본 10, 소수 자릿수 예상)
print(tonumber("1.25")) --> 1.25(기본 10 소수 부분이 있을 수 있습니다)
print(tonumber("3e2")) --> 300(기본 10의 경우 부동 소수점 부분, 3 × 10 ^ 2)
print(tonumber("25", 8)) --> 21(기본 8, 8비트)
print(tonumber("0x100")) --> 256(기본 16, 육각 소수점 지원)
print(tonumber("roblox")) --> nil(오류를 발생시키지 않음)
-- 팁: 잘못 변환할 수 없는 숫자를 올려야 하는 경우 부울을 사용하세요
print(assert(tonumber("roblox"))) --> Error: assertion failed

매개 변수

arg: Variant

변환할 개체를 지정합니다.

base: number

arg를 number1로 변환하는 숫자 기반입니다.

기본값: 10

반환

Variant

tostring

모든 유형의 인수를 받고 합리적인 형식으로 문자열로 변환합니다. 숫자를 전환하는 방법에 대한 자세한 내용은 문자열.format 를 사용하십시오. e의 메타 메서드가 __tostring 이면 결과를 e 만 반환하고 메서드를


local isRobloxCool = true
-- Boolean을 문자열로 변환한 다음 콘센트:
print("Roblox is cool: " .. tostring(isRobloxCool)) --> Roblox is cool: true

매개 변수

e: Variant

변환할 문자열 개체입니다.

반환

type

문자열로 인코딩된 유일한 인수의 유형을 반환합니다. 이 함수의 가능한 결과는 "일"(문자열이 아닌 값 일) "숫자" "문자열" "Boolean" "테이블" "벡터" "함수" "스레드" "사용자 데이터"입니다.

매개 변수

v: Variant

반환할 유형의 개체입니다.

반환

unpack

Variant

요소를 기본 테이블에서 반환합니다. 기본적으로 i 는 1이고, j 는 길이 list 의 길이입니다, 길이 연산자에 따라 정의됩니다.

매개 변수

list: table

해체할 요소 목록입니다.

첫 번째 압축을 풀 인덱스입니다.

기본값: 1

마지막 요소를 풀 인덱스입니다.

기본값: #list

반환

Variant

xpcall

이 함수는 pcall() 와 비슷하지만, 새로운 오류 처리기를 설정할 수 있습니다.

xpcall() 은 보호된

매개 변수

보호 모드에서 호출할 함수입니다.

경험치 콜백이 오류를 발생할 때 사용할 오류 처리 함수입니다.

args: Tuple

반환

Variant

속성

같은 컨텍스트 레벨모든 스크립트 간에 공유되는 테이블입니다.

_VERSION

현재 해석기 버전을 포함하는 문자열을 포함하는 전역 변수(함수가 아님).