如果提供的 `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` 作为错误消信息输出。如果包含错误的函数在保护函数中不被调用，那么包含错误的脚本将被终止。错误函数本身不会返回，并且作为脚本错误返回。

  leve等级 参数指定如何获取错误位置。 使用级别  `1` (默认值)，错误位置是错误函数被调用的地方。 级2 将错误位置指向调用错误的函数； 然后，在消息中添加错误位置信息。 通过级别  `0` 将错误位置添加到消息中。

error

message

level

返回总计算机堆内存大小（千字节）。数字反映操作系统的内部堆内存使用率，随着垃圾收集器释放对象而变化。

gcinfo

返回总计算机内存大小（千字节）。

作为调用者的当前环境，返回一个字典。

  *   如果提供了一个函数，该函数的环境将被返回。
  *   如果提供整数，`Global.LuaGlobals.getfenv()` 将为提供的堆等级提供环境：第 1 级是调用  Global.LuaGlobals

  **警告：** 此函数允许无法控制的更改全球/函数环境，并且禁用脚本优化。对环境的更改不会被脚本分析工具跟踪，可能会导致错误或错误。作为替换，请使用 `Library.debug.info()` 代替。

getfenv

stack

要返回的环境级别（int）；或者将返回的环境变量。

作为调用者的当前环境，返回一个字典。

如果给定的表有一个，返回其 metatable  `t` ，如果它没有，返回 nil。如果 `t` 有一个 metatable，并且 `__metatable` 已设置为 metamethode，它将返回该值。

  ```lua
  -- 展示 getmetatable：
  local meta = {}
  local t = setmetatable({}, meta)
  print(getmetatable(t) == meta) --> 是
  -- 通过设置 __metable 原始表恢复不可能：
  meta.__metatable = "protected"
  print(getmetatable(t)) --> protected
  ```

getmetatable

返回三个值：iteriter 函数、表 `t` 和数字 `0` 。每次调用它的时候，它都会返回表中的下一个数学索引值对。在通用 for-oop 中，使用返回值可以迭代在表中的每个数学索引值：

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

ipairs

返回一个递归函数和一个表以在循环中使用。

从字符串中加载 Lua 代码，并将其作为函数返回。

  与标准 Lua 5.1 不同，Roblox 的 Lua 不能使用 `loadstring()` 加载 Lua 的二进制版本。

  `loadstring()` 默认为禁用。有关启用它的指导，请参阅 `Class.ServerScriptService`。

  **警告：** 此方法会禁用 Luau 优化在返回函数上。 请在使用 `Global.LuaGlobals.loadstring()` 时使用   Global.LuaGlobals.getfenv() 和 0> Global.LuaGlobals.setfenv() 来保护返回函数的环境，以确保用

loadstring

chunkname

用于错误消息和调试信息的可选块名。如果未指定，Lua 使用 `contents` 字符串。

将提供的代码作为可以执行的函数返回。

创建一个空的 `userdata` ，具有可选项以便它有一个 metatable。

newproxy

addMetatable

返回阵数组中的第一个键/值对。如果指定了一个 `lastKey` 参数，则根据提供的键返回阵列中的下一个元素。索引的顺序不是指定的，即使是数字索引。要在表中导航时，请使用一个数学为循环或 `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

在执行时发送到 `func` 的参数。

运行提供的函数，并且在它抛出的任何错误上捕获任何错误，并将其成功和结果返回给函数。

接受任何数量的参数，并将其值打印到输出。 `print` 不是用于格式输出的，但仅作为快速显示值的方式，通常用于调试。 对于格式输出，请使用 `Library.string.format()` 。在 Roblox 上，

print

params

检查是否 `v1` 与 `v2` 无需调用任何 metamethodes。

rawequal

返回是否  `v1` 与 `v2` 平移，以及它们的 metamethodes。

不需要调用任何 мета方法，获得 `table[index]` 的实际值。

rawget

index

通过绕过任何 metamethods 获得 `table[index]` 的实际值。

返回不会调用任何 metameth 的字符串或表的长度。

rawlen

返回字符串或表的长度，无视任何 metamethods 。

设置 `table[index]` 的实际值为指定的 `value` ，而不需要调用任何 metamethode。

rawset

设置在 `t` 到指定的 `value` 。必须与零不同。

值将被设置为指定的 `index` 在表 `t` 中。

通过迂回任何 metamethods 设置 `table[index]` 的实际值。

运行提供的 `Class.ModuleScript` 和返回的

  如上所述，“对象共享”行为不会跨越客户端-服务

  请注意，如果 `Class.ModuleScript` 用户想要运行已上传到 Roblox (用实例名为 `MainModule`)，可以通过使用 `Global.LuaGlobals.require()` 函数在资产 ID 上的 11 2>Class.ModuleScript2> 上加载，尽管仅在服务器上。

require

module

将执行的 `Class.ModuleScript` 以取回它提供的返回值。

什么 `Class.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

在 `args` 后返回所有参数的索引。如果它设置为 `"#"`，那么在它返回后传递的参数数量。

将环境设置为指定给予函数使用。`f` 可以是函数或数量，指定该堆叠等级的函数：第 1 级是 `setfenv()` 。`setfenv()` 返回指定的函数。

  如果  `f` 是  `0` ，那么  `setfenv()` 将运行线程的环境变更为空，并且不返回任何值。

  **警告：** 此功能允许无法控制的更改全球/函数环境，并且禁用脚本优化。对环境的更改不会被脚本分析工具跟踪，可能会导致错误或缺少警告。

setfenv

一个函数或一个数字，指定该堆等级的函数。

fenv

为指定功能设置的函数环境表。

将给定的表 `t` 设置为 `newMeta` 。如果 `newMeta` 为空，表 1> t1> 将被移除。最后，此函数将返回  

  ```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 将被移除。否则，为给定的表设置的 metatable 将为 `t` 。

尝试将参与器转换为指定的基础以解释其中的值。如果无法转换，这个函数将返回 null。

  基地可以是任何数量，它们包括在 2 和 36 之间。在 10 以上的基地上，字母 “A” (在上方或下方) 代表 10， “B” 代表 11，从而类似，“Z” 代表 35。在 10 基地 (默认值) 中，只有未签号的整数，还有一个可选的浮点部分。在其他基地中，只有指定的整数才

  如果字符串开始于 `0x` 且不提供基础，`0x` 将被删除，基础默认为 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 进制、十六进制）
  print(tonumber("0x100")) --> 256 (假设基础 16、十六进制)
  print(tonumber("roblox")) --> nil（不会提升错误）
  -- 提示：如果您想要使用不可转换的数字来提升错误，请使用 with 声明
  print(assert(tonumber("roblox"))) --> Error: assertion failed
  ```

tonumber

base

如果无法，将提供的值返回一个数字或零。

收到任何类型的参数，并将其转换为一个合理格式的字符串。 要完全控制数字如何转换，请使用 string.format。 如果 `e` 的 metabel 有一个 `__tostring` 的 metamethod，它将以 `e` 作为唯一的参数返回结果。

  ```lua
  local isRobloxCool = true
  -- 将Boolean转换为字符串，然后 concatenate：
  print("Roblox is cool: " .. tostring(isRobloxCool)) --> Roblox is cool: true
  ```

tostring

如果无法，将提供的值返回一个字符串或零。

返回其唯一的参数，作为一个字符串编码。这个函数的可能的结果是“nil”（一个字符串，不是值 nil）、“number”、“string”、“Boolean”、“table”、“矢量力ector”、“Function”、“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

概览

指南

教程

参考

资源

艺术

设计

引擎

虚拟形象

旧版本

云端

This method is asynchronous and returns an `Operation`, which represents the current state of the operation. It contains an endpoint path that you can poll to obtain the real response and applicable metadata. See the [documentation]({longRunningOperationsLink}) on long-running operations for more information.
            
The following sections describe the response and metadata objects that are provided when an operation completes.

Beta 测试终点已准备好公开使用。可能出现导致功能无法正常运作的更改，但几率极低。

此字段可能在创建资源时被设置，但可能无法在后续请求中修改。

此字段可以在请求中提供，但永远不会包括在答复中。

每个 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})。

下列对象描述了接受或返回的有效载荷。请参阅每个单独的端点，以了解更多关于这些对象用途的信息。

这将允许查看关于你素材的信息。

这将允许在 Roblox 上传或更新素材。

Grants the ability to update badges owned by the user.

This allows viewing information about your commerce items.

This allows editing of your commerce merchant connections.

This allows you to view information about your Creator Store products.

This allows you to modify information about your Creator Store products.

This allows you to manage group join requests for your account.

这将允许查看你的道具栏信息。

Grants access to mange your badges and spend robux.

Grants access to manage your developer products.

Grants access to read information about the experiences you follow.

Grants access to follow and unfollow experiences on your behalf.

Grants permission to read group information.

Grants access to read and write your localization tables

Grants access to manage team collaboration for all experiences you own.

Grants access to manage your experiences and certain information associated with your experiences (e.g. localization information).

Grants access to read your experiences' localization information.

Grants access to modify your experiences' localization preferences.

Grants access to manage your user account.

Grants access to modify user localization preferences.

授予代替用户发布信息的权力。

This allows sending notifications from your experience to users.

这将允许列出与你的作品相关联的密钥。

这将允许创作和更新与你的作品相关联的密钥。

Grants access to read about your subscription products.

Grants the ability to read place information.

Grants the ability to edit place information.

此操作将会允许发布作品的新版本至 Roblox。

Grants the ability to read experience information.

Grants the ability to edit experience information.

Allows you to view user restrictions in the experience.

Allows you to edit user restrictions in the experience.

Grants the ability to read user's premium and verified status.

This allows you to view a user's social accounts.

默认值：{defaultValueStart}{defaultValueEnd}

数组是一个有序的数值列表。数组有助于存储数据集。

一组键值对，键值可以是任意数字、字符串或对象。

正如{tuples}一样，是一系列的值。

此函数将在可能是立即返回，但在返回值之前可以暂停调用自己的线程。

Roblox 已不再支持或维护{nameStart}名称{nameEnd}。

Roblox 已不再支持或维护这项数学运算。

此成员未在对象浏览器中出现，不应广泛使用。

此成员只能通过命令行访问。从脚本尝试访问此成员将导致错误。

此函数无法暂停调用自己的 Lua 线程。

从脚本尝试访问此成员将导致错误。你可能可以从 Roblox Studio 的属性窗口访问。

此成员不在 Roblox Studio 的对象浏览器中。

你无法使用 Instance.new 构造器创建此类别的实例。

Roblox 不会在跨服务器与客户机界限而复制此成员。

Lua 编程码无法访问此成员。你可能可以从 Roblox Studio 的属性窗口更改其值。

此会员可以从 OpenCloud Luau 执行任务访问。

此对象的复制行为取决于拥有它的玩家。

此成员可以通过命令行和插件访问。从脚本尝试访问此成员将导致错误。

此成员为只读。尝试写入此成员将会导致错误。

此属性为只读，可以从未同步的线程读取。尝试写入可能会导致错误。

只有 Roblox CoreScript 可以访问此成员，Players 不可用。

你可以安全地从多线程对此属性进行读写。

此类别为顶级类单例。使用 GetService 函数获取此类别的实例。

多线程可以写入此属性，所以从未同步的线程读取将会有风险。

此函数在返回借过前将会暂停调用自己的的线程。此操作不会中断其他脚本。