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

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

assert

value

errorMessage

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

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

가비지 수집기의 지정된 작업을 수행합니다. Roblox의 Lua 샌드박스에서는 `count` 옵션만 사용할 수 있지만(총 메모리 사용자에 의해 인터페어되는 메모리 총량), 다른 옵션은 다른 프로세스에 영향을 미칠 수 있습니다. 효과적으로,

collectgarbage

operation

가비지 수집기에 수행해야 하는 작업의 이름입니다.

가비지 수집기의 지정된 작업을 수행합니다.

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

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

error

message

level

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

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

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

gcinfo

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

현재 환경을 다른 사람이 사용하는 디픽터로 반환합니다.

  *   함수를 제공하면 함수의 환경이 반환됩니다.
  *   정수를 제공하면 `Global.LuaGlobals.getfenv()` 는 제공된 스택 수준의 함수 환경을 제공합니다. 레벨

  **경고:** 이 함수는 전역/함수 환경의 제어 없는 변경을 허용하고 스크립트 최적화를 비활성화합니다. 환경에 대한 변경은 스크립트 분석 도구에 의해 추적되지 않으며 결과적으로 누락되거나 잘못된 경고가 발생할 수 있습니다. 대신 `Library.debug.info()`를 사용하는

getfenv

stack

반환될 환경의 레벨(int); 또는 환경을 반환할 함수의 레벨.

현재 환경을 다른 사람이 사용하는 디픽터로 반환합니다.

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

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

getmetatable

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

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

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

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

ipairs

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

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

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

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

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

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

loadstring

chunkname

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

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

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

newproxy

addMetatable

배열에서 첫 번째 키/값 쌍을 반환합니다. `lastKey` 인수가 지정된 경우 배열에 있는 다음 요소를 기반으로 키를 제공한 다음 요소를 배열에 반환합니다. 인덱스는 열거 순서가 지정되지 않습니다. 심지어 숫자 인덱스의 경우 루프 또는 

  다음의 동작은 트래버스 중에 테이블의 기존 필드에 값을 할당하지 않으면 정의되지 않습니다. 하지만 기존 필드를 수정할 수 있습니다. 특히 기존 필드를 지우는 수도 있습니다.

lastKey

이전에 호출한 키를 다음에 검색합니다.

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

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

  ```lua
  local scores = {
      ["John"] = 5,
      ["Sally"] = 10
  }

  for name, score in pairs(scores) do
      print(name .. " has score: " .. score)
  end
  ```

pairs

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

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

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

pcall

func

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

args

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

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

print

params

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

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

rawequal

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

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

rawget

index

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

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

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

rawlen

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

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

rawset

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

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

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

제공된 `Class.ModuleScript` 을 실행하고 제공된 `Class.ModuleScript`

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

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

require

module

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

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

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

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

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

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

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

select

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

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

지정된 함수에 사용할 환경을 설정합니다. `f` 는 함수 또는 해당 스택 레벨함수를 지정하는 숫자일 수 있습니다. `setfenv()` 는 함수를 호출합니다. `setfenv()` 는 지정된 함수를 반환합니다.

  f 가 `0`인 경우, `setfenv()`는 실행 스레드의 환경을 변경하고 값을 반환하지 않습니다.

  **경고::** 이 함수는 글로벌/함수 환경의 제어 없는 변경을 허용하고 스크립트 최적화를 비활성화합니다. 환경에 대한 변경은 스크립트 분석 도구에 의해 추적되지 않으며 결과적으로 오류가 발생할 수 있습니다.

setfenv

해당 스택 레벨함수를 지정하는 함수 또는 숫자입니다.

fenv

지정된 함수에 대해 설정할 함수 환경 테이블입니다.

지정된 함수의 환경을 설정합니다.

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

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

setmetatable

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

newMeta

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

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

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

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

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

  ```lua
  print(tonumber("1337")) --> 1337(기본 10, 소수 자릿수 예상)
  print(tonumber("1.25")) --> 1.25(기본 10 소수 부분이 있을 수 있습니다)
  print(tonumber("3e2")) --> 300(기본 10의 경우 부동 소수점 부분, 3 &times; 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
  ```

tonumber

base

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

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

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

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

tostring

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

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

type

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

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

unpack

list

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

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

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

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

  `xpcall()` 은 보호된

xpcall

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

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

Lua Globals

_VERSION

/reference/engine/globals/LuaGlobals.yaml

Luau

Array

필요 이 스크립트 개체를 호출하면 실행하는 스크립트 개체입니다. 정확히 하나의 값, 일반적으로 함수 테이블,을 다른 스크립트에 반환합니다. 코드를 격리하는 데 유용합니다.

Class

ModuleScript

특정 발생 시 연결된 함수를 실행하는 개체입니다.

Data Type

RBXScriptSignal

Tuple

Variant

값이 true 또는 false인 데이터 형식입니다.

bool

함수는 명령에 여러 번 실행할 수 있는 코드 블록입니다.

function

두 자릿수 부동 소수점 숫자입니다.

number

문자, 숫자 및 기호와 같은 시퀀스.

string

부울, 숫자, 문자열, 함수 및 기타 테이블을 포함한 모든 종류의 값을 저장할 수 있는 데이터 입력.

table

Luau에 있는 임의의 C/C++ 데이터입니다.

userdata

void

개요

가이드

튜토리얼

참조

리소스

아트

디자인

엔진

아바타

클라우드

비동기적 방식으로, 현재 작업 상태를 나타내는 '작업'을 반환합니다. 여기에는 투표를 진행하여 실제 응답과 적용 가능한 메타데이터를 얻을 수 있는 엔드포인트 경로가 포함됩니다. 자세한 정보는 장기 작업에 관한 [설명서]({longRunningOperationsLink})에서 확인하세요.
            
아래 섹션은 작업 완료 시 제공되는 응답 및 메타데이터 개체에 대한 설명입니다.

베타 끝점이 공개적으로 사용될 준비가 되었습니다. 중대한 변경이 발생할 수 있지만 가능성은 낮습니다.

이 필드는 리소스를 생성할 때 설정될 수 있지만 후속 요청에 의해 수정될 수는 없습니다.

이 필드는 요청에 제공될 수 있지만 응답에는 포함되지 않습니다.

각 API 키별: IP 주소당 {periodInSeconds}초마다 {maxInPeriod} 요청

이 필드는 응답에서 설정할 수 있지만 요청에서는 무시됩니다.

이 엔드포인트를 호출하려면 다음 API 키 권한이 필요합니다. 적절한 키 생성에 대한
자세한 내용은 [API 키 관리]({apiKeyReferenceDocLink})에서 확인하세요.

다음 끝점은 기준 URL과 관련된 경로에서 사용할 수 있습니다.

이 문자열은 [FieldMask](/cloud/reference/types#fieldmask) 형식으로 지정됩니다.

JSON 값은 `null`, `boolean`, `string`, `number`, `array`, `object`일 수 있습니다.

OAuth 2.0 애플리케이션에서 이 엔드포인트를 사용하려면 다음 범위가 필요합니다. OAuth 2.0 애플리케이션 등록 방법에 대한 자세한 내용은 [앱 등록 및 심사]({oauth2ReferenceDocLink})에서 확인하세요.

다음 개체는 수락되거나 반환되는 페이로드를 설명합니다. 이러한 개체가 사용되는 시기에 대한 자세한 정보는 각 개별 끝점을 참고하세요.

이 문자열은 [Timestamp](/cloud/reference/types#timestamp) 형식으로 지정됩니다.

이를 통해 애셋에 대한 정보를 볼 수 있습니다.

이를 통해 애셋을 Roblox에 업로드하고 업데이트할 수 있습니다.

사용자가 소유한 배지를 업데이트할 수 있는 권한을 부여합니다.

이를 통해 상거래 아이템에 대한 정보를 볼 수 있습니다.

이를 통해 상거래 판매자 연결을 편집할 수 있습니다.

이를 통해 크리에이터 상점 상품에 대한 정보를 볼 수 있습니다.

이를 통해 크리에이터 상점 상품에 대한 정보를 수정할 수 있습니다.

이를 통해 커뮤니티에 대한 정보를 볼 수 있습니다.

이를 통해 계정에 대한 커뮤니티 가입 요청과 등급이 낮은 커뮤니티 멤버의 역할 업데이트를 관리할 수 있습니다.

이를 통해 인벤토리에 대한 정보를 볼 수 있습니다.

내 배지를 관리할 수 있는 액세스 권한을 부여합니다.

내 배지를 관리하고 Robux를 사용할 수 있는 액세스 권한을 부여합니다.

내 개발자 상품을 관리할 수 있는 액세스 권한을 부여합니다.

팔로우 중인 체험에 대한 정보를 읽을 수 있는 액세스 권한을 부여합니다.

나를 대신해 체험을 팔로우 및 언팔로우할 수 있는 권한을 부여합니다.

내 패스를 관리할 수 있는 액세스 권한을 부여합니다.

내 커뮤니티를 관리할 수 있는 권한을 부여합니다.

커뮤니티 정보를 읽을 수 있는 권한을 부여합니다.

커뮤니티 관리 권한을 부여합니다.

내 로컬라이제이션 테이블을 읽고 쓸 수 있는 액세스 권한을 부여합니다

소유한 모든 체험의 팀 공동 작업을 관리할 수 있는 권한을 부여합니다.

체험 및 체험과 관련된 특정 정보를 관리할 자격을 부여합니다(예: 로컬라이제이션 정보).

내 체험의 로컬라이제이션 정보를 읽을 수 있는 액세스 권한을 부여합니다.

내 체험의 로컬라이제이션 기본 설정을 수정할 수 있는 액세스 권한을 부여합니다.

내 사용자 계정을 관리할 수 있는 권한을 부여합니다.

사용자 로컬라이제이션 기본 설정을 수정할 수 있는 액세스 권한을 부여합니다.

사용자를 대신해 메시지를 게시할 수 있는 권한이 부여됩니다.

이를 통해 체험에서 사용자에게 알림을 보낼 수 있습니다.

이를 통해 체험과 관련된 보안 비밀을 나열할 수 있습니다.

이를 통해 체험과 관련된 보안 비밀을 생성하고 업데이트할 수 있습니다.

구독 상품에 대해 읽을 수 있는 액세스 권한을 부여합니다.

플레이스 정보를 읽을 수 있는 권한을 부여합니다.

플레이스 정보를 편집할 수 있는 권한을 부여합니다.

이 작업은 새로운 버전의 체험을 Roblox에 게시할 수 있는 권한을 부여합니다.

체험 정보를 읽을 수 있는 권한을 부여합니다.

체험 정보를 편집할 수 있는 권한을 부여합니다.

체험에서 사용자 제한을 볼 수 있습니다.

체험에서 사용자 제한을 편집할 수 있습니다.

사용자의 Premium 및 인증 상태를 읽을 수 있는 권한을 부여합니다.

이를 통해 사용자의 소셜 계정을 볼 수 있습니다.

이 작업은 싱글 사인온 기능을 활성화합니다.

프로필 정보를 읽을 수 있는 액세스 권한을 부여합니다.

Lua Globals

요약

함수

속성

함수

assert

매개 변수

반환

error

매개 변수

반환

gcinfo

반환

getmetatable

매개 변수

반환

ipairs

매개 변수

반환

loadstring

매개 변수

반환

newproxy

매개 변수

반환

next

매개 변수

반환

pairs

매개 변수

반환

pcall

매개 변수

반환

print

매개 변수

반환

rawequal

매개 변수

반환

rawget

매개 변수

반환

rawlen

매개 변수

반환

rawset

매개 변수

반환

require

매개 변수

반환

select

매개 변수

반환

setmetatable

매개 변수

반환

tonumber

매개 변수

반환

tostring

매개 변수

반환

type

매개 변수

반환

unpack

매개 변수

반환

xpcall

매개 변수

반환

속성

_G

_VERSION