如果提供的 `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

如果要求失敗，錯誤中將顯示的文字。

如果提供的 `value` 解釋為 `false` 或 `nil` ，則會發生錯誤。

執行垃圾收集器的指定操作。注意，Roblox 的 Lua 沙盒只允許使用 `count` 選項 (使用 Lua 的內存總量，以千兆計)，因為其他選項可能會與現有程序互礙。 有效地，這使 `Global.LuaGlobals.gcinfo()` 成為一個優於此的選擇，應該使用。

collectgarbage

operation

垃圾收集器應該執行的操作的名稱。

終止最後一個受保護的函數，並將 `message` 作為錯誤訊息輸出。如果包含錯誤的功能在受保護功能中沒有被呼叫，則會發永久停權 `pcall()` 的錯誤訊息。錯誤功能本身不會返回，並且作為錯誤訊息顯示。

  level 參數指定如何取得錯誤位置。使用 `1` （預設值），錯誤位置是錯誤功能所在的地方。使用 `0` （預設值），錯誤位置是錯誤功能所在的地方；然後再過一個等級 1>01> 就會跳過錯誤位置訊息息。4>04> 通過一個等級

error

message

level

返回總計存取記憶體的大小，以千兆位表示。數字反映操作系統的內存使用率，這會隨著垃圾收集器釋放物件而變化。

gcinfo

返回使用者當前環境的地圖，作為辭典。

  *   如果提供了一個函數，則將返回其環境。
  *   如果提供整數，`Global.LuaGlobals.getfenv()` 將提供當前層等級的環境：第 1 級是  Global.L

  **警告：** 此功能允許對全球環境進行非控制變更，並且停用程式碼最佳化。對環境的變更不會被腳本分析工具跟蹤，可能會導致錯誤或遺失警告。作為替代，請考慮使用 `Library.debug.info()` 代替。

getfenv

stack

環境的資源級別 (int) 或環境的函數。

返回使用者當前環境的地圖，作為辭典。

如果有一個，返回指定的表的 metabel `t` ，否則返回零。如果 `t` 有 metabel，並且 `__metatable` 已設定，它將返回指定的值。

  ```lua
  -- 展示 getmetatable：
  local meta = {}
  local t = setmetatable({}, meta)
  print(getmetatable(t) == meta) --> 是
  -- 設置 __metable 的 metameth 方法，讓原始的 metitable 無法恢復：
  meta.__metatable = "protected"
  print(getmetatable(t)) --> protected
  ```

getmetatable

返回三個值：iter 函數、表 `t` 和數字 `0` 。每次呼叫 iter 函數時，它將返回表中的下一個數學索引值雙。在一般 for-Loop 中，將返回值可以在表中索引的所有數學索引值：

  ```lua
  local fruits = {"apples", "oranges", "kiwi"}
  for index, fruit in ipairs(fruits) do
     print(index, fruit) --> 1 蘋果，2 橘子，3  kiwi，等等...
  end
  ```

ipairs

返回一個iterator 函數和一個表，以便在循環中使用。

從字串載入 Lua 代碼，並以函數返回。

  與標準 Lua 5.1 不同，Roblox 的 Lua 無法使用 `loadstring()` 載入 Lua 的二進版本。

  `loadstring()` 是由預設啟用。 要取得有關啟用它的指南，請參閱 `Class.ServerScriptService`。

  **警告：** 此方法會在返回的函數上禁用某些 Luau 最佳化。極端小心應該在使用 `Global.LuaGlobals.loadstring()` ；如果您的意圖是允許用戶在您的體驗中執行程式碼，請確保保護返回的函數的環

loadstring

chunkname

一個可選的Chunk名稱，用於錯誤訊息和調試資訊。如果未指定，Lua會使用 `contents` 字串。

返回提供的代碼作為可執行的函數。

建立一個空白 `userdata` ，並且有可能包含 metatable。

newproxy

addMetatable

返回陣列中的第一個鑰匙/值對。如果指定了 `lastKey` 參數，則會在陣列中按照提供的鑰匙返回下一個元素。索引的順序不指定，即使是數字索引也一樣。若要在表中瀏覽，請使用 `ipairs` 或 ipairs 。

  下一個行為將在穿越時，如果您在表中的非存在欄位指定任何值，無效。 您可以修改已存在的欄位，例如清除已存在的欄位。

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

返回一個ITERATOR 函數和提供的表，以在 `for` 循環中使用。

在保護模式中，呼叫 `func` 並且將所提供的參數傳入。這意味著任何在 `func` 內發生的錯誤都不會傳訊息；相反， `pcall()` 會捕

pcall

func

可以在保護模式中呼叫的函數。

args

執行提供的函數，並檢查其所發生的任何錯誤，以返回功能的成功和結果。

接受任何數量的參數，並將其值打印到輸出。 `print` 不適用於格式輸出，但只是一種快速的方式來顯示值，通常用於調試。對於格式輸出，請使用 `Library.string.format()` 。在 Roblox

print

params

檢查是否 `v1` 與 `v2` 平等，而不需要召喚任何 metamethodes。

rawequal

返回是否 `v1` 與 `v2` 平等，或 v1 與 1> v21> 平等。

不需要呼叫任何 metamethodes 來取得 `table[index]` 的實際值。

rawget

index

獲得 `table[index]` 的實際值，並且忽略任何 metamethodes。

不需要呼叫任何 metamethode 返回字串或表的長度。

rawlen

將 `table[index]` 的實際值設置為 `value` ，而不需要呼叫任何 metamethode。

rawset

將索引設置在 `t` 到指定的 `value` 。必須與零不同。

值將被設置為指定的 `index` 在表中 `t` 。

使用 `table[index]` 的實際值，無視任何 metamethode。

執行提供的 `Class.ModuleScript` 並返回由 `Class.ModuleScript` 返回的值。 當 Global.LuaGlobals.r需要 必填quire 回來時，其他 2>

  如上所述，「對象共享」行為不會

  請注意，如果 `Class.ModuleScript` 要運行的用戶想要運行已上傳到 Roblox (使用 `MainModule` 的實例名稱)，可以使用 `Global.LuaGlobals.require()` 函數在資產 ID 的 1> Class.ModuleScript1> 上載入。

require

module

會執行的 `Class.ModuleScript`，以取回它提供的返回值。

Class.ModuleScript 返回的值 (通常為表或函數)。

返回指定ModuleScript的值，如果尚未執行。

在 argument 數字後 `index` 返回所有參數。如果為負，它將從 argument 列表的末端返回。

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

  如果 `index` 參數設為 `"#"`，則在它返回後傳送的參數數量。

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

select

在 `args` 後返回所有參數的索引。如果它設為 `"#"`，則在它返回後所傳送的參數數量。

將環境設定為使用指定的函數。`f` 可以是一個函數或數字，指定該層等級的函數：第一級是 `setfenv()` 。`setfenv()` 返回指定的函數。

  如果 `f` 是 `0` ，那麼 `setfenv()` 會改變執行線程的環境並且不會返回任何值。

  **警告：** 此功能允許不受控制的變更全球/功能環境，並且停用指令碼最佳化。對環境的變更不會被指令分析工具跟蹤，可能會導致錯誤或遺失警告。

setfenv

一個或多個數字，指定該堆等級的函數。

fenv

為指定功能設置的函數環境表。

將指定的表 `t` 設為 `newMeta` 。如果 `newMeta` 為零，則會移除指定的表 1> t1> 的 met表。最後，此功

  ```lua
  local meta = {__metatable = "protected"}
  local t = {}
  setmetatable(t, meta) -- 這設置 t 的 metatable
  -- 我們現在有一個表，t，與一個 metatable。如果我們嘗試改變它...
  setmetatable(t, {}) --> Error: cannot change a protected metatable
  ```

setmetatable

newMeta

如果為零，則將提供的表的 metatable `t` 移除。否則，提供的表的 metatable `t` 。

嘗試將 arg 變成指定的數字，以解釋值。如果無法轉換，此函數將返回 nil。

  基地可以是任何數字，例如 2 和 36 之間的整數。在基地上 10 之上，字母 'A' (在上方或下方) 代表 10，'B' 代表 11，並且以 'Z' 代表 35。在其他基地中，只有已簽名的整數才能接受。

  如果串從 `0x` 開始，並且不提供基地，`0x` 將被裁剪，並且基地將預設為 16，或 hexadecimal。

  ```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, 十六進制)
  print(tonumber("0x100")) --> 256 (假設基地 16、十六進制)
  print(tonumber("roblox")) --> nil (不會提升錯誤)
  -- 提示：如果您想要使用不可轉換的數字來提升錯誤，請使用與此說明中的「用於」
  print(assert(tonumber("roblox"))) --> Error: assertion failed
  ```

tonumber

base

如果無法，將提供的值轉換為數字或零。

接受任何類型的參數，並將其轉換為合理格式的字串。對數字的轉換方式進行完全控制，請使用 string.format。如果 `e` 的 metabel 包含 `__tostring` 的 metamethode，則會以 `e` 作為唯一的參數返回結果。

  ```lua
  local isRobloxCool = true
  -- 將Boolean轉換為字串，然後結合：
  print("Roblox is cool: " .. tostring(isRobloxCool)) --> Roblox is cool: true
  ```

tostring

如果無法，將提供的值轉換為字串或零。

返回僅有的參引數，以字串的形式編寫。這個函數的可能結果是 "nil" (一個字串，不是值 nil)、 "number"、 "string"、 "button"、 " thread" 和 "userdata"。

type

從指定的表中返回元素。 預設值為，`i`是1，`j`是`list`的長度，按照長度操作器的定義。

unpack

list

將所有元素從指定的列表中作為範圍返回。

這個函數與 `Global.LuaGlobals.pcall()` 相似，但你可以設定新的錯誤處理器。

  `xpcall()` 在保��

xpcall

如果 xpcall 發生錯誤，將使用此功能作為錯誤處理。

與 `Global.LuaGlobals.pcall()` 類似，但使用自訂錯誤處理器。

Lua Globals

_VERSION

/reference/engine/globals/LuaGlobals.yaml

一個 Lua 的函數和變數的列表。

Luau

Array

一種用於 `require` 被呼叫時執行的指令對象。返回正確的值，通常是一個表的函數，給其他指令使用。對於分離代碼有用。

Class

ModuleScript

連接到特定發生時執行的對象。

Data Type

RBXScriptSignal

Tuple

Variant

bool

函數是可以在指令上多次執行的代碼區塊。

function

number

字母、數字和符號等的一系列字符。

string

可以存儲多個非零型值的資料類輸入，包括 booleans、數字、字串、函數和其他桌子。

table

在 Luau 中存在的任意 C/C++ 資料。

userdata

void

概覽

指南

教學

參考

資源

美術

設計

引擎

虛擬人偶

舊版本

雲端

此方式不同步且返回「操作」，這代表操作的目前狀態。它包含終點路徑，您可以取用以獲得實際回應和適用的中繼資料。詳情請參閱長期執行操作上的 [文件]({longRunningOperationsLink})。
            
以下部分描述操作完成時提供的回應和中繼資料物件。

Beta 測試終點已準備好公開使用。可能出現導致功能無法正常運作的變更，但機率不高。

建立資源時可設定此欄位，但可能無法在後續請求中修改。

此欄位可在請求中提供，但永遠不會包含在回應中。

每個 API 金鑰：每個 IP 位址每 {periodInSeconds} 秒 {maxInPeriod} 個請求

此欄位可在回應中設定，但將在請求中被忽略。

調用此端點需要以下 API 金鑰權限。有關
產生正確金鑰的更多資訊，請查看 [管理 API 金鑰]（{apiKeyReferenceDocLink}）。

根據相對基本網址的路徑，可使用下列終點。

此字串的格式為 [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。

讓您檢視體驗中的使用者限制。

讓您在體驗中編輯使用者限制。

授予讀取使用者高級會員狀態與驗證狀態的能力。

這能讓您檢視使用者的社群帳號。

這將授予讀取您個人檔案資訊的權限。

預設值：{defaultValueStart}{defaultValueEnd}

陣列是值的有序列表。陣列在儲存資料組合時很實用。

一組鍵值對，鍵可以是任何數字、字串或物件。

此函式將允許時將會立刻傳回，但在能傳回值之前可以暫停呼叫自己的執行緒。

Roblox 已不再支援或維護 {nameStart}name{nameEnd}。

Roblox 已不再支援或維護這項數學運算。

此成員未在物件瀏覽器出現，不應廣泛使用。

此成員只能透過指令列存取。從指令碼存取此成員將會導致錯誤。

此函式無法暫停呼叫自己的 Lua 執行緒。

在指令碼存取此成員將會導致錯誤。您可能可以從 Roblox Studio 的屬性視窗存取此成員。

此成員不再 Roblox Studio 的物件瀏覽器中。

您無法使用 Instance.new 建構式建立此類別的個體。

Roblox 不會跨越伺服器與用戶端界限而複製此成員。

Lua 程式碼無法存取此成員。您可能可以從 Roblox Studio 的屬性視窗變更其值。

此成員可從 OpenCloud Luau 執行任務存取。

此物件的複製行為取決於擁有的玩家。

此成員能透過指令列和外掛程式存取。從指令碼存取此成員將會導致錯誤。

此為唯讀成員。寫入此成員將會導致錯誤。

此為唯讀屬性，可以在未同步的執行緒讀取。嘗試寫入將會導致錯誤。

只有 Roblox CoreScript 可以存取此成員，Player 不可使用。

您可以安全地從多個執行緒對此屬性讀寫。

此類別為頂層 Singleton。使用 GetService 函式取得此類別的個體。

多個執行緒可以寫入此屬性，從未同步的執行緒讀取將有風險。

此函式在傳回結果前將會暫停呼叫自己的執行緒。此操作不會中斷其他指令碼。