Tablas

El tipo de datos de la tabla puede almacenar múltiples valores de cualquier tipo que no sea , incluidos booleanos , números , cadenas , funciones y otras tablas.Construir tablas con curly braces ( {} ):


-- Construir una tabla vacía asignada a la variable "t"
local t = {}
print(t) -- {}

Puedes usar una tabla como array o diccionario.Los arreglos utilizan una lista ordenada de números como índices, pero los diccionarios pueden tener números, cadenas y objetos como índices.

Para obtener más información sobre las funciones integradas para trabajar con tablas, consulte la biblioteca table.

Arreglos

Un array es una lista ordenada de valores.Los arreglos son útiles para almacenar colecciones de datos, como un grupo de jugadores con permisos especiales.

Crear matrices

Para crear un array usando una tabla Luau, declare los valores en orden secuencial, separados por comas.


-- Construir un array con tres elementos
local testArray = {"A string", 3.14159, true}
print(testArray)

Leer de arrays

Para leer de un array, agregue un par de paréntesis cuadrados después de su referencia y especifique el número de índice del elemento dentro ( [pos] ):


-- Construir un array con tres elementos
local testArray = {"A string", 3.14159, true}

print(testArray[1]) -- Una cadena
print(testArray[2]) -- 3.14159
print(testArray[3]) -- true

A diferencia de algunos idiomas, Luau usa la indexación basada en 1 para arrays, por lo que el primer elemento en el array es [1] , no [0] .

Escribir a arrays

Para definir o reescribir el valor de un array en un índice, declare el número de índice en paréntesis cuadrados ( [index] ) seguido de = y el valor:


local testArray = {"A string", 3.14159, true}

testArray[2] = 12345
testArray[4] = "New string"

print(testArray[2]) --12345
print(testArray[4]) -- New string

Iterar sobre arrays

Para iterar sobre un array, puedes usar un bucle for .Debido a que los arrays tienen índices numéricos, también puedes usar un bucle numérico for de 1 a la longitud del array (#array).


local testArray = {"A string", 3.14159, true, "New string"}

-- Bucle usando iteración general
for index, value in testArray do
	print(index, value)
end

-- Iterar usando el operador de longitud de array (#)
for index = 1, #testArray do
	print(index, testArray[index])
end

Insertar artículos

Hay dos maneras integradas de insertar un elemento al final de un array :

Pasa una referencia al array y el valor del elemento a la función table.insert() de Luau.
Añade el nuevo elemento al array utilizando la sintaxis array[#array+1].


local testArray = {"A string", 3.14159}

table.insert(testArray, "New string")
testArray[#testArray+1] = "Another new string"

print(testArray[3]) -- Nueva cadena
print(testArray[4]) -- Another new string

Para insertar un elemento entre el comienzo y el final de un array, incluya un valor de posición como el segundo argumento de table.insert() .Esto inserta el nuevo elemento y empuja los siguientes elementos a una posición de índice.


local testArray = {"First item", "Next item"}

table.insert(testArray, 2, "NEW ITEM #2")

print(testArray[1]) -- Primer artículo
print(testArray[2]) -- NUEVO ARTÍCULO #2
print(testArray[3]) -- Next item

Quitar artículos

Para eliminar un elemento de un array, utilice table.remove() .Esto elimina el elemento en la posición especificada y mueve cualquier elemento siguiente de vuelta una posición de índice.


local testArray = {"First item", "Next item", "Last item"}

table.remove(testArray, 2)

print(testArray[1]) -- Primer artículo
print(testArray[2]) -- Last item

Diccionarios

Los diccionarios son una extensión de los arrays. Los diccionarios almacenan un conjunto de pares clave-valor, donde las claves pueden ser cualquier número, cadena o objeto.

Crear diccionarios

Para crear una tabla de diccionario, define cada clave seguida de = y el valor . Separa cada pareja de clave-valor con una coma:


local testDictionary = {
	fruitName = "Lemon",
	fruitColor = "Yellow",
	sour = true
}

Las claves para diccionarios pueden ser números, cadenas y objetos.Por ejemplo, una clave también puede ser un Instance .Para usar objetos como claves, declare la clave en paréntesis cuadrados ( [key] ):


local part = Instance.new("Part")

local testDictionary = {
	partType = "Block",
	[part] = true
}

Leer de diccionarios

Para leer de un diccionario, añade un par de paréntesis después de su referencia y especifica el nombre de la clave.Haga referencia directamente a una clave de cadena usando ( ["key"] ) o ( .key ), o use un valor de variable ( [key] ).


local part = Instance.new("Part")

local testDictionary = {
	partType = "Block",
	[part] = true
}
-- Incluir citas para las claves de cadena
print(testDictionary["partType"]) -- Bloquear
-- O use . para indexar las claves de cadena sin espacios
print(testDictionary.partType) -- Bloquear
-- Omitir citas para claves no de cadena
print(testDictionary[part]) -- true

Escribir a diccionarios

Para definir o reescribir el valor de una nueva o existente clave de diccionario, declare el nombre de la clave en paréntesis ( [key] ) o, si la clave es una cadena, use ( .key ) seguido de = y el valor:


local testDictionary = {
	fruitName = "Lemon",
	sour = true
}

-- Cambiar el valor de las llaves existentes
testDictionary["fruitName"] = "Cherry"
testDictionary.sour = false

-- Insertar nuevo par de clave-valor
testDictionary.fruitCount = 10

print(testDictionary.fruitName) -- Cereza
print(testDictionary.sour) -- falso
print(testDictionary.fruitCount) -- 10

Iterar sobre diccionarios

Para iterar sobre un diccionario, utilice un bucle for :


local testDictionary = {
	fruitName = "Lemon",
	fruitColor = "Yellow",
	sour = true
}

for key, value in testDictionary do
	print(key, value)
end

--[[ Resultado de salida:
fruitName Lemon
sour true
fruitColor Yellow
]]

Eliminar pares de clave-valor

Para eliminar o borrar una pareja de clave-valor de un diccionario, establece su valor para una clave en nil .


local testDictionary = {
	fruitName = "Lemon",
	fruitColor = "Yellow",
	sour = true
}

testDictionary.sour = nil

for key, value in testDictionary do
	print(key, value)
end
--[[ Resultado de salida:
fruitName Lemon
fruitColor Yellow
]]

Tablas como referencias

Si almacenas una tabla en una nueva variable, Luau no crea una copia de esa tabla.En cambio, la variable se convierte en una referencia de o puntero a la tabla original.Cualquier referencia a una tabla refleja cualquier cambio en la tabla original:


local originalArray = {10, 20}

local arrayReference = originalArray

print("Original:", originalArray[1], originalArray[2])
print("Reference:", arrayReference[1], arrayReference[2])

-- Cambiar valores en el array original
originalArray[1] = 1000
originalArray[2] = 2000

print("Reference:", arrayReference[1], arrayReference[2])

--[[ Resultado de salida:
Original: 10 20
Reference: 10 20
Reference: 1000 2000
]]

Tablas de clonado

Clones poco profundos

Para copiar una tabla sin tablas anidadas, Luau ofrece el método table.clone().


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

local clone = table.clone(original)

Clones profundos

Para copiar una tabla más compleja con tablas anidadas dentro de ella, necesitarás usar una función recursiva similar a la siguiente:


-- La función utilizada para clonar profundamente una tabla
local function deepClone(original)
	-- Define la nueva tabla para la copia
	local clone = table.clone(original) 

	-- Repetir a través de la tabla original para verificar los valores de la tabla
	-- Si se encuentra una tabla como valor, clonarla profundamente a la clave (índice)
	for key, value in original do
		if type(value) == "table" then
			clone[key] = deepClone(value)
		end
	end

	-- Devolver la copia finalizada de la tabla clonada profunda
	return clone
end

Con la función en su lugar, puedes hacer una copia profunda como sigue:


local original = {
	key = "value",
	playerInfo = {
		playerID = 505306092,
		playerName = "PlayerName"
	},
	otherInfo = {
		{
			{1, 3, 5, 7, 9}
		}
	}
}

local clone = deepClone(original)

Congelar tablas

Congelar una tabla la hace de lectura única, lo que es útil para crear valores constantes que no quieres cambiar.El congelamiento es permanente; no hay método de "descongelación" o "deshielo".Para verificar si una tabla está congelada, use table.isfrozen() .

Congelaciones superficiales

Para congelar una tabla sin tablas anidadas, Luau ofrece el método table.freeze().


local target = {
	key = "value",
	engine = "Roblox",
	playerID = 505306092
}

table.freeze(target)
target.playerID = 1 --> attempt to modify a readonly table

Congelaciones profundas

Para congelar una tabla más compleja con tablas anidadas dentro de ella, utilice una función recursiva similar a la siguiente:


local function deepFreeze(target)
	-- Congelación superficial de la tabla
	table.freeze(target)

	-- Compruebe cada clave de la tabla y congélela si es una tabla
	for _, value in target do
		-- Asegúrese de que el valor no esté congelado; si ya lo está, ocurrirá un error
		if type(value) == "table" and table.isfrozen(value) == false then
			deepFreeze(v)
		end
	end
end

Con la función en su lugar, puedes congelar profundamente una tabla como sigue:


local target = {
	key = "value",
	playerInfo = {
		playerID = 505306092,
		playerName = "PlayerName"
	},
	otherInfo = {
		{
			{1, 3, 5, 7, 9}
		}
	}
}

deepFreeze(target)
target.playerInfo.playerID = 1 --> attempt to modify a readonly table

En esta página