Luau globals

Lanza un error si el proporcionado value es false o nil . Si la afirmación pasa, devuelve todos los valores que se le pasaron.

local product = 90 * 4
assert(product == 360, "Oh dear, multiplication is broken")
-- The line above does nothing, because 90 times 4 is 360

Termina la última función protegida llamada y produce message como un mensaje de error.Si la función que contiene el error no se llama en una función protegida como pcall(), entonces el script que llamó la función terminará.La función de error en sí nunca regresa y actúa como un error de script.

El argumento level especifica cómo obtener la posición del error.Con el nivel 1 (el predeterminado), la posición de error es donde se llamó la función de error.El nivel 2 apunta el error a donde se llamó la función que llamó el error; y así sucesivamente.Pasar un nivel 0 evita la adición de información de posición de error a el mensaje.

Devuelve el tamaño total del heap de memoria en kilobytes.El número refleja el consumo actual de la pila desde la perspectiva del sistema operativo, que fluctúa con el tiempo a medida que el recolector de basura libera objetos.

Devuelve el metatable de la tabla dada t si tiene uno, de lo contrario devuelve nil .Si t tiene un metatable, y el __metatable metamétodo está configurado, devuelve ese valor en lugar.

-- Demostrar getmetitable:
local meta = {}
local t = setmetatable({}, meta)
print(getmetatable(t) == meta) --> cierto
-- Haz que el metadato original no se pueda recuperar estableciendo el metamétodo __metatable:
meta.__metatable = "protected"
print(getmetatable(t)) --> protected

Devuelve tres valores: una función iteradora, la tabla t y el número 0.Cada vez que se llama la función iteradora, devuelve el siguiente par de índice-valor numérico en la tabla.Cuando se usa en un bucle for genérico, los valores de devolución se pueden usar para iterar sobre cada índice numérico en la tabla:

local fruits = {"apples", "oranges", "kiwi"}
for index, fruit in ipairs(fruits) do
   print(index, fruit) --> 1 manzanas, 2 naranjas, 3 kiwi, etc...
end

Carga código Luau de una cadena y lo devuelve como función.

A diferencia del Lua estándar 5.1, Luau de Roblox no puede cargar el código binario compilado usando loadstring() .

loadstring() está deshabilitado por defecto. Para obtener orientación sobre cómo habilitarlo, consulte ServerScriptService .

ADVERTENCIA: Este método desactiva ciertas optimizaciones de Luau en la función devuelta.Se debe tener mucho cuidado al usar loadstring() ; si tu intención es permitir que los usuarios ejecuten código en tu experiencia, asegúrate de proteger el entorno de la función devuelta usando getfenv() y setfenv() .

Crea un vacío userdata , con la opción de que tenga una tabla metálica.

Devuelve el primer par de clave/valor en el array.Si se especificó un argumento lastKey entonces devuelve el siguiente elemento en el array basado en la clave que se proporcionó.No se especifica el orden en que se enumeran los índices, incluso para los índices numéricos.Para recorrer una tabla en orden numérico, utilice un bucle numérico o ipairs .

El comportamiento de siguiente no está definido si, durante la exploración, asignas cualquier valor a un campo no existente en la tabla.Sin embargo, puedes modificar campos existentes.En particular, puedes borrar campos existentes.

Devuelve una función iteradora, la tabla pasada t , y nil , para que la construcción iterará sobre todos los pares clave/valor de esa tabla cuando se utiliza en un bucle genérico for :

local scores = {
    ["John"] = 5,
    ["Sally"] = 10
}

for name, score in pairs(scores) do
    print(name .. " has score: " .. score)
end

Llama a la función func con los argumentos dados en modo protegido.Esto significa que cualquier error dentro de func no se propaga; en cambio, pcall() captura el error y devuelve un código de estado.Su primer resultado es el código de estado (un booleano), que es verdadero si la llamada tiene éxito sin errores.En tal caso, pcall() también devuelve todos los resultados de la llamada, después de este primer resultado.En caso de cualquier error, pcall() devuelve false más el mensaje de error.

local function divideByFive(n: number): number
	return n / 5
end

local success, errorMessage = pcall(divideByFive, "notANumber")  -- Resultados en error...

if success then
	-- Manear respuesta exitosa...
else
	warn("Error message:", errorMessage)
end

Recibe cualquier número de argumentos y los imprime en el resultado. print no está destinado a la salida formatada, pero solo como una forma rápida de mostrar un valor, generalmente para la depuración.Para una salida formatada, use string.format() .En Roblox, print no llama a tostring , pero el método metálico __tostring sigue disparando si la tabla tiene uno.

Comprueba si v1 es igual a v2 sin invocar ningún metamétodo.

Obtiene el valor real de table[index] , sin invocar ningún metamétodo.

Devuelve la longitud de la cadena o de la tabla, sin invocar ningún metamétodo.

Establece el valor real de table[index] a un dado value, sin invocar ningún metamétodo.

Ejecuta el suministrado ModuleScript y devuelve lo que el ModuleScript devolvió (normalmente una tabla o una función).Si el ModuleScript no se ha ejecutado aún, se ejecutará.

Si se proporciona un camino de cadena en lugar de eso, se resuelve primero a un ModuleScript relativo al script que llamó require() , imitando la semántica Unix-like de la expresión de Luau require().

En particular, la semántica de resolución de require-by-string es la siguiente:

• Los caminos con el prefijo ./ comienzan la resolución en script.Parent .
• Los caminos con el prefijo ../ comienzan la resolución en script.Parent.Parent .
• Los caminos con el prefijo @self/ comienzan la resolución en script .
• Cada componente sin prefijo en un camino dado se corresponde con una instancia hija del componente anterior.La excepción a esto es el componente .., que corresponde al padre del componente anterior.
• Si el deseado ModuleScript no está presente en el momento en que se llama require(), la llamada fallará y se lanzará un error.En otras palabras, require-by-string es no bloqueante: no espera implícitamente a que se cree un ModuleScript para ser creado.

Para ilustrar esto, cada par de require() expresiones en el ejemplo a continuación contiene dos llamadas funcionalmente equivalentes.Se han agregado parentesis redundantes para aclarar exactamente cómo se mapea cada componente de ruta a una instancia.

-- El prefijo "/" es equivalente a script.Parent
require("./MySibling")
require((script.Parent).(MySibling))

-- El prefijo "../" es equivalente a script.Parent.Parent
require("../SiblingOfMyParent")
require((script.Parent.Parent).(SiblingOfMyParent))

-- /" puede ser enlazado para subir múltiples niveles
require("../../SiblingOfMyGrandparent")
require((script.Parent.Parent).(Parent).(SiblingOfMyGrandparent))

-- el prefijo "@self" se corresponde con el propio script
require("@self/MyChild")
require((script).(MyChild))

Una vez que el objeto de devolución se crea por una llamada inicial de de un , las llamadas futuras de (del mismo lado del límite cliente-servidor) no ejecutarán el código nuevamente.En cambio, se proporcionará una referencia al objeto de devolución mismo creado por la llamada inicial require().Este comportamiento permite el intercambio de valores entre diferentes scripts, ya que varias llamadas require() de diferentes scripts se referirán al mismo objeto devuelto.Si el objeto devuelto es una tabla, todos los valores almacenados dentro de la tabla se comparten y son accesibles por cualquier script que requiera que ModuleScript.

Como se señaló anteriormente, el comportamiento de "compartir objetos" no cruza la frontera cliente-servidor.Esto significa que si un ModuleScript es accesible tanto para el cliente y servidor (como al ser colocado en ReplicatedStorage ) y require() es llamado tanto de un LocalScript como de un Script , el código en el ModuleScript se ejecutará dos veces, y el LocalScript recibirá un objeto de devolución distinto del que recibió el Script .

Tenga en cuenta también que si el ModuleScript el usuario quiere ejecutar se ha subido a Roblox (con el nombre de la instancia siendo MainModule ), se puede cargar usando la función require() en la ID del activo del ModuleScript , aunque solo en el servidor.

Devuelve todos los argumentos después del número de argumento index. Si es negativo, devolverá desde el final de la lista de argumentos.

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

Si el argumento index se establece en "#", el número de argumentos que se pasaron después de que se devuelve.

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

Establece el metatable para la tabla dada t a newMeta .Si newMeta es nil , se elimina el metatable de t .Por último, esta función devuelve la tabla t que se le pasó a ella.Si t ya tiene una tabla metálica cuyo __metatable metamétodo está configurado, llamar a esto en t levanta un error.

local meta = {__metatable = "protected"}
local t = {}
setmetatable(t, meta) -- Esto establece el metatable de t
-- Ahora tenemos una tabla, t, con un metatable. Si intentamos cambiarlo...
setmetatable(t, {}) --> Error: cannot change a protected metatable

Intentos de convertir el arg en un número con una base especificada para interpretar el valor en.Si no se puede convertir, esta función devuelve nil .

La base puede ser cualquier entero entre 2 y 36, incluido.En bases superiores a 10, la letra 'A' (en mayúscula o minúscula) representa 10, 'B' representa 11, y así sucesivamente, con 'Z' representando 35.En base 10 (el predeterminado), el número puede tener una parte decimal, así como una parte de exponente opcional.En otras bases, solo se aceptan enteros no firmados.

Si una cadena comienza con 0x y una base no se proporciona, la 0x se recorta y se supone que la base es de 16, o hexadecimal.

print(tonumber("1337")) --> 1337 (asume la base 10, decimal)
print(tonumber("1.25")) --> 1.25 (la base 10 puede tener porciones decimales)
print(tonumber("3e2")) --> 300 (la base 10 puede tener una parte de exponente, 3 × 10 ^ 2)
print(tonumber("25", 8)) --> 21 (base 8, octubre)
print(tonumber("0x100")) --> 256 (asume la base 16, hexadecimal)
print(tonumber("roblox")) --> nil (no levanta un error)
-- Consejo: utilice con Assert si desea números no convertibles para levantar un error
print(assert(tonumber("roblox"))) --> Error: assertion failed

Recibe un argumento de cualquier tipo y lo convierte a una cadena en un formato razonable.Para obtener un control completo de cómo se convierten los números, use string.format.Si el metatable de e tiene un __tostring metamétodo, se llamará con e como único argumento y devolverá el resultado.

local isRobloxCool = true
-- Convierte el booleano a una cadena y luego concatena:
print("Roblox is cool: " .. tostring(isRobloxCool)) --> Roblox is cool: true

Devuelve el tipo de su único argumento, codificado como una cadena.Los resultados posibles de esta función son "nil" (una cadena, no el valor nil), "number" , "string" , "boolean" , "table" , "vector" , "function" , "thread" , "userdata" , y "buffer" .Los primitivos buffer y vector son adiciones de Luau, no de Lua.

Devuelve los elementos de la tabla dada.Por defecto, i es 1 y j es la longitud de list , definida por el operador de longitud.

Esta función es similar a pcall(), excepto que puedes establecer un nuevo manejador de errores.

xpcall() llama a la función f en modo protegido, usando err como manejador de errores, y pasa una lista de argumentos.Cualquier error dentro de f no se propaga; en cambio, xpcall() captura el error, llama la función err con el objeto de error original y devuelve un código de estado.Su primer resultado es el código de estado (un booleano), que es verdadero si la llamada tiene éxito sin errores.En este caso, xpcall() también devuelve todos los resultados de la llamada, después de este primer resultado.En caso de cualquier error, xpcall() devuelve false más el resultado de err .

A diferencia de pcall() , la función err preserva el rastro de pila de la función f , que se puede inspeccionar usando debug.info() o debug.traceback() .

Una tabla que se comparte entre todos los scripts del mismo nivel de contexto.

Una variable global (no una función) que contiene una cadena que contiene la versión actual del intérprete.