该库提供用于表/数组操作的通用函数，
所有函数都在全局 `Library.table` 变量中。`Library.table` 库中的大多数
函数假设表表示数组或列表。对于这些函数，表的 "长度" 意味着
长度操作符的结果。

将给定表中所有键的值设置为 `nil`。这会导致
`#` 操作符对给定表返回 `0`。表的数组部分的分配容量
保持不变，这允许高效地重用空间。

```lua
local grades = {95, 82, 71, 92, 100, 60}
print(grades[4], #grades) --> 92, 6
table.clear(grades)
print(grades[4], #grades) --> nil, 0
-- 如果 grades 再次填充相同数量的条目，
-- 不会发生潜在昂贵的数组调整，因为通过 table.clear 维护了容量。
```
此函数不会删除/销毁提供给它的表。此
函数专门用于将要重用的表。

table.clear

table

将给定表中的所有键设置为 `nil`。

返回提供表的未冻结浅拷贝。

```lua
local original = {
	key = "value",
	engine = "Roblox",
	playerID = 505306092
}

local clone = table.clone(original)
```

table.clone

给定一个所有元素都是字符串或数字的数组，返回
字符串 `t[i] ... sep ... t[i+1] ... sep ... t[j]`。sep 的默认值为
空字符串，`i` 的默认值为 1，`j` 的默认值为 #t。如果 i 大于 `j`，则返回空字符串。

table.concat

将在表中每个条目之间连接的字符串。

由分隔符连接的表元素的连接字符串。


将给定范围的表元素作为字符串返回，每个元素
用给定分隔符分隔。

创建一个表，数组部分分配给给定的 `number` 个
元素，选填用给定的 `value` 填充。

```lua
local t = table.create(3, "Roblox")
print(table.concat(t)) --> RobloxRobloxRoblox
```
如果你在大型类似数组的表中插入，并且对元素数量有合理的上限，建议使用
此函数来初始化表。这确保表的数组
部分的内存足够大，因为调整其大小可能会很昂贵。对于少量元素，这通常不明显。

table.create

count

在新表的数组部分中分配的元素数量。


value

用于填充每个元素的值。如果省略，则元素保持为
`nil`。


一个新的表，其数组部分预分配为 `count` 个元素，
如果提供了 `value` 则填充该值。


返回一个新表，该表用指定值的多个实例填充。

在给定的类似数组的表 `haystack` 中，从索引 `init` 开始查找
值 `needle` 的第一次出现，如果未提供则从开头开始。如果未找到该值，返回 `nil`。

执行一个 [线性搜索](https://en.wikipedia.org/wiki/Linear_search) 算法。

```lua
local t = {"a", "b", "c", "d", "e"}
print(table.find(t, "d")) --> 4
print(table.find(t, "z")) --> nil，因为 z 不在表中
print(table.find(t, "b", 3)) --> nil，因为 b 出现在索引 3 之前
```

table.find

haystack

needle

init

开始搜索的索引。默认为 `1`。


第一个出现的 `needle` 的数字索引，如果未找到则为 `nil`。


返回在 `haystack` 中第一次出现 `needle` 的索引，
从 `init` 开始。

迭代提供的表，将每次迭代的键和值传递给提供的函数。此函数已被弃用，
不建议在新代码中使用；请改用 `for` 循环。

table.foreach

将在迭代中使用的函数。此函数将在每次迭代中接收 2 个参数，第一个参数是
键，第二个参数是值。

迭代提供的表，将每次迭代的键和值传递给提供的函数。

这与 `Library.table.foreach()` 相似，只是传递的是索引-值对，而不是键-值对。此函数已被弃用，
不建议在新代码中使用；请改用 `for` 循环。

table.foreachi

将在迭代中使用的函数。此函数将在每次迭代中接收 2 个参数，第一个参数是
索引，第二个参数是值。

类似于 `Library.table.foreach()`，但传递的是索引-值对，而不是键-值对。

此函数将给定表设置为只读，有效地"冻结"其当前状态。尝试修改冻结的表会抛出错误。

这种冻结效果是浅层的，这意味着你可以在冻结表内的表中写入。要深度冻结表，需递归调用此函数
在所有子表上。

table.freeze

返回传递的表中的元素数量。此函数已被弃用，
不建议在新代码中使用；请使用 `#t` 替代。

table.getn

表的数组部分的长度，相当于 `#`
运算符。


在位置 `pos` 将 `value` 插入数组 `t` 中，向上移动元素
`t[pos], t[pos+1], ..., t[#t]` 一位。位置必须在 `1` 和 `#t`
（包括）之间才能发生移动；然后该值写入 `t[pos]`。

```lua
local t = {"a", "b", "c"}
table.insert(t, 2, "new")
print(table.concat(t, ", ")) --> a, new, b, c
```


table.insert

将提供的值插入到数组的目标位置。

将 `value` 附加到数组 `t` 的末尾，位置为 `#t + 1`。与
位置重载不同，不会移动现有元素，使得这是通过一个元素扩展数组的
最有效方法。

```lua
local t = {"a", "b", "c"}
table.insert(t, "d")
print(table.concat(t, ", ")) --> a, b, c, d
```


将提供的值追加到数组的末尾。

此函数返回 `true` 如果给定的表被冻结，
如果没有被冻结则返回 `false`。你可以使用 `Library.table.freeze()` 冻结表。

table.isfrozen

表是否被 `Library.table.freeze()` 冻结。

如果给定的表被冻结，则返回 `true`，如果没有
冻结，则返回 `false`。

返回提供表的最大数值键，如果表没有数值键则返回零。表中的空隙将被忽略。

table.maxn

表中最大的正数字键，如果表没有数字键则为 `0`。


返回提供表的最大数值键，如果表没有数值键则返回零。

将表 `src` 中从 `src[a]` 到 `src[b]` 的元素复制到表 `dst`，从索引 `t` 开始。等价于赋值语句 `dst[t], ..., dst[t + (b - a)] = src[a], ..., src[b]`。

`dst` 的默认值为 `src`。目标范围可以与源范围重叠。为方便起见，返回 `dst`。

```lua
local sourceTable = {4, 5} -- 要复制的数据表
local destTable = {1, 2, 3} -- 添加复制数据的表

table.move(
	sourceTable, -- 源表
	1, -- 源表中开始的索引
	#sourceTable, -- 直到（包含）源表的索引
	#destTable + 1, -- 目标表中移动数据的索引
	destTable -- 目标表
)
print(destTable) --> {1, 2, 3, 4, 5}
```

table.move

将一个表的指定范围元素复制到另一个表。

返回一个新表，其中所有参数存储到键 1、2 等，并且
有一个字段 "n"，表示参数总数。请注意，
结果表可能不是一个序列。

```lua
local t = table.pack(1, 2, 3)
print(table.concat(t, ", ")) --> 1, 2, 3
```

table.pack

values...

一个新表，键为 `1` 到 `n` 的参数，以及一个 `n` 字段
存储总参数数量。


返回一个新表，包含提供的值。

从数组 t 中移除位置 pos 的元素，返回移除元素的值。
当 pos 是介于 `1` 和 `#t` 之间的整数时，
它将下移元素 `t[pos+1], t[pos+2], ..., t[#t]` 并擦除
元素 `t[#t]`。如果未提供 pos 参数，pos 默认为
表的长度，移除最后一个元素。

table.remove

被移除元素的值，如果位置超出范围则为无。


从数组中移除指定元素，如果可能，将后续元素下移
to 填充空白空间。

对数组 t 的元素进行排序，从 `t[1]` 到 `t[#t]`。如果
给定了 `comp`，则必须是一个函数，该函数接收两个元素并
在第一个元素必须在最终顺序中位于第二个元素之前时返回 true。

如果 `comp(a, b)` 和 `comp(b, a)` 都返回 `true`，则会抛出错误 `invalid order function for sorting`。

如果未给定 `comp`，则使用标准 Luau 操作符 `<`。

table.sort

comp

用于比较表中元素的可选比较函数。此函数接收两个元素，并应
返回 true，如果第一个元素应在最终顺序中排在第二个元素之前。

使用提供的比较函数或 `<` 操作符对表元素进行排序。

返回给定列表中的元素。默认情况下，`i` 为 1，`j` 为
`list` 的长度。

请注意，这一相同功能也由全局 `Global.LuaGlobals.unpack()` 函数提供。

table.unpack

list

要展开的最后一个元素的索引。

元素 `list[i], list[i+1], ..., list[j]` 作为单独的返回
值。


返回给定列表中的所有元素作为元组。

Luau

{any}

一个在特定事件发生时运行连接的函数的对象。

Data Type

RBXScriptSignal

Tuple

Variant

boolean

函数是可以根据命令多次执行的代码块。

function

number

一系列字符，如字母、数字和符号。

string

数据类型，可以存储多个任意非 nil 类型的值，包括布尔值、数字、字符串、函数和其他表。

体验

虚拟形象

素材

范例和项目

引擎 API

Open Cloud API

Studio

分析

平台

教程

创作者计划

教育

学习

此方法是异步的，会返回一个`Operation`对象，该对象表示操作的当前状态。它包含一个端点路径，您可以轮询该路径以获取实际响应和相关的元数据。有关长时间运行操作的更多信息，请参阅[文档]({longRunningOperationsLink})。

以下部分描述了操作完成时提供的响应和元数据对象。

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

这些 Open Cloud 文档页面将于 2026 年 3 月 31 日移除。届时你将被自动重定向到新的 Open Cloud 文档。{linkStart}了解更多{linkEnd}

这些旧 Open Cloud 页面将于 2026 年 3 月 31 日移除并重定向。{linkStart}了解更多{linkEnd}

实验性终端节点已准备好供公众使用，但随着 API 协定的最终确定，可能偶尔会出现重大变更。

此终端节点可通过使用 API 密钥的 {httpServiceLinkStart}HttpService{httpServiceLinkEnd} 在体验中调用。

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

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

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

旧版验证方法。始终首选使用 API 密钥或 OAuth 2.0（如有）。

每个 API 密钥：每个 IP 地址每 {periodInSeconds} 秒有 {maxInPeriod} 次请求

无需身份验证即可调用。通常会显著降低速率限制。始终首选使用 API 密钥或 OAuth 2.0（如有）。

对于每个分组，只需提供架构中的以下字段之一，其余字段可以排除。

你可以随时重新选择加入。{linkStart}提供反馈。{linkEnd}

你正在查看旧版文档。{linkStart}提供反馈。{linkEnd}

你可以随时退出，并重定向回旧的引用页面。{linkStart}在这里提供反馈。{linkEnd}

你正在查看全新改版的文档。{linkStart}提供反馈。{linkEnd}

此字段可能被设置为响应，但在请求中将被忽略。

注意：在高流量期间，速率限制可能会更低。某些终端节点有额外的速率限制。[进一步了解速率限制]({link})。

用户或群组所有 API 密钥每天 {limit} 个请求

用户或群组所有 API 密钥每小时 {limit} 个请求

用户或群组所有 API 密钥每分钟 {limit} 个请求

用户或群组所有 API 密钥每秒 {limit} 个请求

每个 API 密钥所有者每分钟 {limit} 个请求

每个 App 用户每天 {limit} 个请求

每个 App 用户每小时 {limit} 个请求

每个 App 用户每分钟 {limit} 个请求

每个 App 用户每秒 {limit} 个请求

每个 API 密钥所有者每秒 {limit} 个请求

范围可以控制你的凭据拥有哪些权限。你的凭据只能访问你所选范围支持的终端节点。

稳定终端节点已准备好投入生产使用，在其生命周期内几乎不会发生重大变更。

此目标允许你将密钥的访问权限限制为选定的{requiredParts}

此目标允许你将密钥的访问权限限制为选定的{requiredParts}和{optionalParts}

目标类型用于限制你的凭据可操作的资源。即使你的帐户拥有其他资源的权限，也只能处理选定的资源。某些范围没有目标部件，在这种情况下，你的所有相关资源都可进行操作。

对于用户拥有的 API 密钥，无需选择宇宙顶级部件。在这种情况下，你的 API 密钥可以访问你拥有的所有个人体验，以及你在群组中拥有相应权限的群组体验。

尚不支持试用需要 API 密钥或 OAuth 2.0 验证的终端节点

为了安全起见，已停用高风险操作的 Cookie 验证。

关键风险终端节点非常敏感，为了安全起见，已停用“试用”

注意：此代码示例中不包含验证标头。你可能需要添加验证标头，以便此命令能够正常运作。

这是会修改或删除关键数据的高风险终端节点。测试时要格外小心。

此 API 终端节点已被归类为高风险，可能会影响实时数据或用户帐户。

对高风险 API 的已验证请求可能会进行无法撤销的更改。请在继续之前仔细查看你的请求参数。

这是会取回数据的低风险终端节点。通常可以安全测试。

这是会修改数据的中风险终端节点。请使用非关键帐户仔细测试，因为更改可能是永久性的。

为了确保你帐户的安全，请不要在此处粘贴来自其他来源的文本，或将此页面的信息发送给其他人。

你即将使用实际帐户凭据测试实时 API 终端节点。

只有在你了解即将进行的 API 调用的影响后才能继续。在测试之前，请仔细查看 API 文档。

将使用已验证的会话进行 API 调用

这些是可能影响你帐户或数据的真实 API 调用

某些操作可能会修改或删除数据

此终端节点已被以下推荐的替代终端节点取代：

调用此终端节点需要以下范围。如需
有关生成正确密钥的更多信息，请参阅 [管理 API 密钥]({apiKeyReferenceDocLink})。

如需有关生成密钥的更多信息，请参阅 [管理 API 密钥]({apiKeyReferenceDocLink})。

相对于基础 URL 的路径，下列端点是可用的。

此字符串格式为 [FieldMask](/cloud/reference/types#fieldmask)。

JSON 值可以是 “null”、“boolean”、“string”、“number”、“array” 或 “object”。

你的 OAuth 2.0 应用程序需要以下范围才能使用此终端节点。如需进一步了解如何注册 OAuth 2.0 应用程序，请参阅 [App 注册和审核]({oauth2ReferenceDocLink})。

如需进一步了解如何注册 OAuth 2.0 应用程序，请参阅 [App 注册和审核]({oauth2ReferenceDocLink})。

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

调用此终端节点需要以下范围。

资源路径

若要使用此端点，你的 OAuth 2.0 应用程序需要以下范围。关于如何注册 OAuth 2.0 应用程序的更多信息，请查看【应用程序注册及评价】({oauth2ReferenceDocLink})。

不推荐

你正在查看更新后的 Open Cloud 引用。

你已退出新的 Open Cloud 引用。

授予配置账单账户和购买广告点数的权限。

创建、更新和管理你的广告活动。

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

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

允许查看你的帐户有权访问的主体（包括群组和体验）和素材。

这将允许向你帐户有权访问的任何主体（包括群组和体验）和素材授予素材权限。

允许代表你查看虚拟形象自动设置任务的状态和结果。

允许代表你创建和管理虚拟形象自动设置任务。

授予更新用户拥有的徽章的能力。

这将允许查看有关你商业项目的信息。

这将允许更改你的同步商业项目。

这将允许查看有关你商户联结平台的信息。

这将允许编辑你的商户联结平台。

这将允许你查看关于你创作者商店产品的信息。

这将允许你修改关于你创作者商店产品的信息。

这将允许你查看关于你创作者商店保存的信息。

这将允许你修改关于你创作者商店保存的信息。

授予代表你创建数据存储的权限。

授予代表你删除数据存储的权限。

授予读取数据存储列表的权限。

授予拍摄数据存储快照的权限。

授予在数据存储中创建条目的权限。

授予标记要删除的指定条目的权限。

授予列出数据存储条目的权限。

授予读取数据存储中指定条目的权限。

授予更新条目的值、属性和用户的权限。

授予删除数据存储条目修订的权限。

授予列出数据存储条目修订的权限。

授予读取数据存储条目修订的权限。

授予查看授权用户的开发者产品配置详细信息的权限。

授予编辑授权用户的开发者产品的权限。

这将允许查看有关你宇宙环境的信息。

授予查看授权用户的游戏通行证配置详细信息的权限。

授予编辑授权用户的游戏通行证的权限。

授予查看你的帐户社区论坛信息的权限。

授予访问权限，允许管理你的帐户对应的社区论坛信息。

这将允许查看有关你社区的信息。

这将允许你管理社区加入请求，并处理你帐户中低级别社区成员的角色更新。

允许你修改实例的属性数据（目前仅支持脚本）。

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

授予权限，以管理你的徽章并使用 Robux。

授予更新授权用户徽章的权限。

授予读取你已开启通知的体验信息的权限。

授予代表你开启或关闭体验通知的权限。

授予读取和写入本地化表格的权限

授予为你拥有的所有体验管理团队协作的权限。

授予管理体验和与体验相关的某些信息（例如本地化信息）的权限。

授予读取体验本地化信息的权限。

授予修改体验本地化偏好设置的权限。

授予修改用户本地化偏好设置的权限。

允许你查看关联场景的 Luau 执行任务的状态、日志和结果。

允许你为关联场景创建新的 Luau 执行任务。

授予异步清空宇宙中所有数据结构的权限。

授予从队列前端丢弃已读项目的权限。

授予读取队列前端项目的权限。

授予读取记忆存储项目的权限。

授予创建、更新和删除地图项目的权限。

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

这将允许从你的体验向用户发送通知。

（已弃用）授予读取有序数据存储中条目列表的权限。

（已弃用）授予在有序数据存储中创建新条目的权限。

授予从有序数据存储中列出条目的权限。

授予在有序数据存储中创建条目的权限。

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

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

此权限允许你提交评估工作并查看工作结果。

授予读取订阅产品信息的权限。

授予创建或修改分析提醒的权限。

Grants the ability to read custom analytics dashboards.

Grants the ability to create or modify custom analytics dashboards.

授予写入游戏分析相关资源的权限。

授予在 Roblox 上发布新版本体验的权限。

允许读取体验的缩略图和缩略图个性化设置。

允许上传和删除缩略图，并管理体验的缩略图个性化设置。

授予编辑授权用户体验的权限。

允许你查看体验中的用户限制。

允许你编辑体验中的用户限制。

允许查看发送至你帐户的通知。

授予读取用户 Premium 和验证状态的能力。

这将允许你查看授权用户的社交帐户。

这将授予读取你的个人资料信息的权限。

摘要