Sets the value for all keys within the given table to nil. This causes the
`#` operator to return `0` for the given table. The allocated capacity of
the table's array portion is maintained, which allows for efficient re-use
of the space.

```lua
local grades = {95, 82, 71, 92, 100, 60}
print(grades[4], #grades) --> 92, 6
table.clear(grades)
print(grades[4], #grades) --> nil, 0
-- If grades is filled again with the same number of entries,
-- no potentially expensive array resizing will occur
-- because the capacity was maintained by table.clear.
```

This function does not delete/destroy the table provided to it. This
function is meant to be used specifically for tables that are to be
re-used.


table.clear

table

Sets all keys in the given table to nil.


Returns an unfrozen shallow copy of the provided table.


table.clone

Returns a shallow copy of the provided table.


Given an array where all elements are strings or numbers, returns the
string `t[i] ... sep ... t[i+1] ... sep ... t[j]`. The default value for
sep is an empty string, the default for `i` is 1, and the default for `j`
is #t. If i is greater than `j`, returns the empty string.


table.concat

The table that will be converted into a string.


The string that will be concatenated between each entry in the table.


The starting index of the table concatenation.


The ending index of the table concatenation.


Returns the given range of table elements as a string where each element
is separated by the given separator.


Creates a table with the array portion allocated to the given `number` of
elements, optionally filled with the given `value`.

```lua
local t = table.create(3, "Roblox")
print(table.concat(t)) --> RobloxRobloxRoblox
```

If you are inserting into large array-like tables and are certain of a
reasonable upper limit to the number of elements, it's recommended to use
this function to initialize the table. This ensures the table's array
portion of its memory is sufficiently sized, as resizing it can be
expensive. For small quantities this is typically not noticeable.


table.create

count

value

Returns a new table populated with many instances of the specified value.


Within the given array-like table `haystack`, find the first occurrence of
value `needle`, starting from index `init` or the beginning if not
provided. If the value is not found, `nil` is returned.

A [linear search](https://en.wikipedia.org/wiki/Linear_search) algorithm
is performed.

```lua
local t = {"a", "b", "c", "d", "e"}
print(table.find(t, "d")) --> 4
print(table.find(t, "z")) --> nil, because z is not in the table
print(table.find(t, "b", 3)) --> nil, because b appears before index 3
```


table.find

haystack

needle

init

Returns the index of the first occurrence of `needle` within `haystack`
starting from `init`.


Iterates over the provided table, passing the key and value of each
iteration over to the provided function.


table.foreach

The function that will be used for the iteration. This function will
receive 2 arguments for each iteration, where the 1st argument is the
key, and the 2nd argument is the value.


This is similar to table.foreach() except that index-value pairs are
passed, not key-value pairs.


table.foreachi

The function that will be used for the iteration. This function will
receive 2 arguments for each iteration, where the 1st argument is the
index, and the 2nd argument is the value.


Similar to table.foreach() except index-value pairs are passed instead of
key-value pairs.


This function makes the given table read-only, effectively "freezing" it
in its current state. Attempting to modify a frozen table throws an error.

This freezing effect is shallow, which means that you can write to a table
within a frozen table. To deep freeze a table, call this function
recursively on all of the descending tables.


table.freeze

Returns the number of elements in the table passed.


table.getn

Inserts the provided value to the target position of the array.


table.insert

The position at which the value will be inserted.


The value that will be appended to the table.


Appends the provided value to the end of the array.


This function returns `true` if the given table is frozen and `false` if
it isn't frozen. You can freeze tables using `Library.table.freeze()`.


table.isfrozen

Whether the table is frozen from `Library.table.freeze()`.


Returns `true` if the given table is frozen and `false` if it isn't
frozen.


Returns the maximum numeric key of the provided table, or zero if the
table has no numeric keys. Gaps in the table are ignored.


table.maxn

Returns the maximum numeric key of the provided table, or zero if the
table has no numeric keys.


Copies elements from table `src` into table `dst`. Is equivalent to the
multiple assignment statement: `dst[t], ... = src[a], ..., src[b]`.

The default for `dst` is `src`. The destination range may overlap with the
source range.

Returns `dst` for convenience.


table.move

Copies the specified range of elements from one table to another.


Returns a new table with all arguments stored into keys 1, 2, etc. and
with a field "n" with the total number of arguments. Note that the
resulting table may not be a sequence.

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


table.pack

values...

Returns a new table containing the provided values.


Removes from array t the element at position pos, returning the value of
the removed element. When pos is an integer between `1` and `#t`, it
shifts down the elements `t[pos+1], t[pos+2], ..., t[#t]` and erases
element `t[#t]`. The index `pos` can also be `0` when `#t` is `0` or
`#t+1`; in those cases, the function erases the element `t[pos]``.


table.remove

The table that is having an element removed.


Removes the specified element from the array, shifting later elements down
to fill in the empty space if possible.


Sorts elements of array t in a given order, from `t[1]` to `t[#t]`. If
`comp` is given, then it must be a function that receives two elements and
returns true when the first element must come before the second in the
final order (so that not `comp(t[i+1],t[i])` will be true after the sort).
If `comp` is not given, then the standard Lua operator `<` is used
instead.


table.sort

comp

An optional comparison function to be used when comparing elements in
the table. This function receives two elements, `a` and `b`, and
should return true if `a < b`.


Sorts table elements using the provided comparison function or the `<`
operator.


Returns the elements from the given list. By default, `i` is 1 and `j` is
the length of `list`.

Note that this same functionality is also provided by the global
`Global.LuaGlobals.unpack()` function.


table.unpack

list

The index of the first element to unpack.


The index of the last element to unpack.


Returns all elements from the given list as a tuple.


Luau

Array

An object that runs connected functions upon a specific occurrence.

Data Type

RBXScriptSignal

Tuple

Variant

Data type having a value of either true or false.

bool

Functions are blocks of code that can execute multiple times on command.

function

A double-precision floating-point number.

number

A sequence of characters, such as letters, numbers, and symbols.

string

Data type which can store multiple values of any non-nil type, including booleans, numbers, strings, functions, and other tables.

void

Visão geral

Guias

Tutoriais

Referência

Recursos

Arte

Design

Motor

Avatar

Nuvem

Este campo pode ser definido ao criar um recurso, mas não pode ser modificado por solicitações subsequentes.

Este campo pode ser fornecido em solicitações, mas nunca será incluído em respostas.

Por chave de API: {maxInPeriod} solicitações a cada {periodInSeconds} segundos por endereço IP

Este campo pode ser definido como respostas, mas será ignorado em solicitações.

As seguintes permissões de chave API são requeridas para chamar este endpoint. Para mais informações sobre gerar chaves apropriadas, veja [Gerenciando chaves API]({apiKeyReferenceDocLink}).

Os seguintes endpoints estão disponíveis em caminhos relativos à URL base.

Esta cadeia de caracteres está formatada como um [FieldMask](/cloud/reference/types#fieldmask).

Um valor JSON pode ser `null`, `boolean`, `string`, `number`, `array`, ou `object`.

Os seguintes escopos são necessários para que sua aplicação OAuth 2.0 use este endpoint. Para obter mais informações sobre como registrar um aplicativo OAuth 2.0, consulte [Registro do aplicativo e revisão]({oauth2ReferenceDocLink}).

Os seguintes objetos descrevem payloads que são aceitos ou retornados. Veja cada endpoint para mais informações sobre quando esses objetos são usados.

Esta cadeia de caracteres é formatada como um [Timestamp](/cloud/reference/types#timestamp).

Os seguintes escopos são necessários para que sua aplicação OAuth 2.0 use este endpoint. Para obter mais informações sobre como registrar um aplicativo OAuth 2.0, consulte [Registro e revisão do aplicativo]({oauth2ReferenceDocLink}).

Isto permite visualizar informações sobre seus ativos.

Isto permite enviar e atualizar ativos para a Roblox.

Isso permite que você visualize informações sobre seus produtos da Loja do Criador.

Isso permite que você modifique informações sobre seus produtos da Loja de Criadores.

Isso permite que você gerencie solicitações de adesão de grupos para sua conta.

Isto permite visualizar informações sobre seu inventário.

Isto permite publicar mensagens em nome de um usuário.

Isso permite o envio de notificações da sua experiência aos usuários

Isto permite listar segredos aliados à sua experiência.

Isto permite criar e atualizar segredos relacionados à sua experiência.

Concede a capacidade de ler informações do local.

Concede a capacidade de editar as informações do local.

Esta operação permite acesso para publicar novas versões de experiências para a Roblox.

Concede a capacidade de ler informações da experiência.

Concede a capacidade de editar informações da experiência.

Permite que você veja restrições de usuário na experiência.

Permite que você edite restrições de usuário na experiência.

Concede a capacidade de ler o status Premium e verificado do usuário.

Isso permite que você veja as contas sociais de um usuário.

Isto habilita a funcionalidade de logon único

Isso permite acesso à leitura das informações do seu perfil

Valor padrão: {defaultValueStart}{defaultValueEnd}

Um array é uma lista ordenada de valores. Arrays são úteis para armazenar coleções de dados.

Um conjunto de pares chave-valor, onde as chaves podem ser qualquer número, string ou objeto.

Essa função retorna imediatamente, se possível, mas pode gerar a sequência que a chamou até que possa retornar um valor.

{nameStart}nome{nameEnd} não é mais suportado ou mantido pela Roblox.

Essa operação matemática não é mais suportada ou mantida pela Roblox.

Este membro não aparece no navegador de objetos e não é para uso geral.

Este membro só é acessível somente através da barra de comandos. Tentar acessar este membro a partir de scripts causa um erro.

Esta função não pode pausar o tópico Lua que a chamou.

Tentar acessar este membro em scripts causa um erro. Você pode ser capaz de acessar este membro na janela de propriedades do Roblox Studio.

Este membro não aparece no Navegador de Objetos do Roblox Studio.

Não é possível criar uma instância desta classe com o construtor Instance.new.

A Roblox não replica este membro além do limite do seu servidor-cliente.

O código Lua não pode acessar este membro. Você pode ser capaz de alterar o valor dele na janela de propriedades do Roblox Studio.

O comportamento de replicação do objeto depende do jogador que o possui.

Este membro é acessível somente através da barra de comandos e plugins. Tentar acessar este membro a partir de scripts causa um erro.

Esta propriedade é somente leitura e é segura para ler em tópicos não sincronizados. Tentar escrever nela causa um erro.

Esta propriedade é somente leitura e é segura para ler em threads não sincronizadas. Tentar escrever nela causa um erro.

Este membro é somente leitura. Tentar escrever para este membro causa um erro.

Este membro é acessível somente no CoreScripts.

Somente o Roblox CoreScripts pode acessar este membro e ele não é utilizável por jogadores.

Você pode ler e escrever para esta propriedade com segurança a partir de várias threads.

Esta classe é uma singleton de alto nível. Recupere uma instância desta classe com a função GetService.

Várias threads podem potencialmente escrever para esta propriedade, então não é seguro ler a partir de threads não sincronizadas.

Você pode ler e escrever para esta propriedade com segurança a partir de vários tópicos.

Esta função pausa a thread Lua que a chamou até que ela retorne um resultado. Isto não interrompe outros scripts.

Aprenda a criar conteúdo bem-sucedido no Roblox com guias abrangentes, amostras de código, referência e tutoriais.


{pageTitle} | {SiteName}

título

Não é possível adicionar ao inventário

A amostra de código {title} foi adicionada ao seu inventário.

A versão {versionNumber} inclui melhorias gerais de desempenho e correções de bugs. Confira as nossas outras notas de lançamento sobre melhorias específicas e erros.

Não inclua informações privadas ou pessoais. No máximo {maxDescriptionLength} palavras.

Mínimo de {minDescriptionLength} palavras necessárias na descrição.

Notas de Lançamento para o Roblox Studio versão {versionNumber}

Estamos tornando as coisas ainda mais incríveis. Agradecemos sua paciência.

Clicando em "Continuar", você será direcionado(a) para {redirectLinkStart}{redirectLinkEnd}

Este site não pertence ou é operado pela Roblox. Ele pode ter diferentes termos e políticas de privacidade.

table

Resumo

Funções

Funções

clear

Parâmetros

Devolução

clone

Parâmetros

Devolução

concat

Parâmetros

Devolução

create

Parâmetros

Devolução

find

Parâmetros

Devolução

foreach

Parâmetros

Devolução

foreachi

Parâmetros

Devolução

freeze

Parâmetros

Devolução

getn

Parâmetros

Devolução

insert

Parâmetros

Devolução

insert

Parâmetros

Devolução

isfrozen

Parâmetros

Devolução

maxn

Parâmetros

Devolução

move

Parâmetros

Devolução

Amostras de código

pack

Parâmetros

Devolução

remove

Parâmetros

Devolução

sort

Parâmetros

Devolução

unpack

Parâmetros

Devolução