table
*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.
Esta biblioteca proporciona funciones genéricas para la manipulación de tablas/matrices, proporcionando todas sus funciones dentro de la variable global table . La mayoría de las funciones en la biblioteca table asumen que la tabla representa un matriz. Para estas funciones, la "Longitud" de una tabla significa el resultado del operador de longitud.
Resumo
Funções
Establece todas las llaves en la tabla dada a nulo.
Devuelve una copia baja de la tabla proporcionada.
Devuelve el rango dado a los elementos de la tabla como una cadena donde cada elemento está separado por el separador dado.
Regresa una nueva tabla llena de muchas instancias del valor especificado.
Devuelve el índice de la primera ocurrencia de needle dentro de haystack que comienza desde init .
Hace que la tabla dada sea solo de lectura.
Inserta el valor proporcionado a la posición objetivo del matriz/lista.
Añade el valor proporcionado al final del matriz/lista.
Devuelve true si la tabla que se ha dado está congelada y false si no está congelada.
Devuelve la llave numérica máxima de la tabla proporcionada, o cero si no tiene llaves numéricas.
Copia el rango especificado de elementos de una tabla a otra.
Regresa una nueva tabla que contiene los valores proporcionados.
Elimina el elemento especificado del matriz/lista, moviendo los elementos siguientes para llenar el espacio vacío si es posible.
Ordena los elementos de la tabla usando la función de comparación proporcionada o el operador <.
Devuelve todos los elementos de la lista dada como un tupla.
Funções
clear
Establece el valor de todas las llaves dentro de la tabla dada a nulo. Esto causa que el operador # devuelva 0 por la tabla dada. La capacidad almacenada de la parte del arreglo de la tabla se mantiene, lo que permite un uso eficiente del espacio.
local grades = {95, 82, 71, 92, 100, 60}print(grades[4], #grades) --> 92, 6table.clear(grades)print(grades[4], #grades) --> nulo, 0-- Si las calificaciones se llenan de nuevo con el mismo número de entradas,-- no se producirsereubicación de matriz de precio potencialmente costoso-- because the capacity was maintained by table.clear.
Esta función no elimina/destruye la tabla proporcionada. Esta función se destina a ser usada específicamente para las tablas que se reutilizan.
Parâmetros
La tabla cuyas llaves se eliminarán.
Devolução
concat
Dado un arreglo donde todos los elementos son cadenas o números, devuelve la cadena t[i] ... sep ... t[i+1] ... sep ... t[j] . El valor predeterminado para sep es un valor vacío, el valor predeterminado para i es 1, y el valor predeterminado para j es #t. Si i es mayor
Parâmetros
Devolução
create
Crea una tabla con la parte de arreglo asignada al elemento dado number de elementos, opcionalmente llena con el dado value .
local t = table.create(3, "Roblox")print(table.concat(t)) --> RobloxRobloxRoblox
Si está insertando en grandes tablas de arreglo como y está seguro de un límite de arreglo razonable para el número de elementos, se recomienda utilizar esta función para inicializar la tabla. Esto garantiza que la parte de arreglo del tabla de su memoria sea lo suficientemente grande, ya que escalarla puede ser costosa. Para pequeñas cantidades esto generalmente no es notorio.
Parâmetros
Devolução
find
Dentro de la tabla dada en forma de matriz haystack, encuentra la primera ocurrencia de valor needle , comenzando desde el índice init o el comienzo si no se proporciona. Si el valor no se encuentra, 1> nil1> se devuelve.
Se realiza un algoritmo de búsqueda lineal.
local t = {"a", "b", "c", "d", "e"}print(table.find(t, "d")) --> 4print(table.find(t, "z")) --> nil, porque z no está en la tablaprint(table.find(t, "b", 3)) --> nil, because b appears before index 3
Devolução
freeze
Esta función hace que la tabla dada sea solo de lectura, lo que la hace efectivamente "congelar" en su estado actual. Intentar modificar una tabla congelada da un error.
Este efecto de congelación es superficial, lo que significa que puedes escribir en una tabla dentro de una tabla congelada. Para congelar profundamente una tabla, llama a esta función recursivamente en todas las tablas descendentes.
Parâmetros
La tabla que se va a congelar.
Devolução
La mesa congelada.
insert
Añade el valor proporcionado al final del matriz/lista.
Parâmetros
La tabla que se está añadiendo.
El valor que se añadirá a la tabla.
Devolução
isfrozen
Esta función devuelve true si la tabla que se ha dado está congelada y false si no está congelada. Puedes congelar tablas usando table.freeze() .
Parâmetros
La tabla para verificar, comprobar.
Devolução
Si la tabla está congelada desde table.freeze() .
move
Copia elementos en la tabla src de src[a] hasta src[b] en la tabla 1> dst1> comenzando con el índice 4> t4> . Equivalente a la declaración de asignación 7> dst[t], ..., ds
El valor predeterminado para dst es src . El rango de destino puede coincidir con el rango de origen.
Regresa dst para conveniencia.
Parâmetros
Devolução
dst , para conveniencia.
pack
Regresa una nueva tabla con todos los argumentos almacenados en las llaves 1, 2, etc. y con un campo "n" con el número total de argumentos. Nota que la tabla resultante puede no ser una secuencia.
local t = table.pack(1, 2, 3)print(table.concat(t, ", ")) --> 1, 2, 3
Parâmetros
Devolução
remove
Elimina del elemento de arreglo el elemento en la posición pos, devolviendo el valor del elemento eliminado. Cuando pos es un número entre 1 y #t , se desplaza hacia abajo los elementos t[pos+1], t[pos+2], ..., t[#t] y elimina el elemento 1>
Parâmetros
Devolução
sort
Ordena los elementos de la matriz en un ordenado específico, desde t[1] a t[#t] . Si se da el caso, comp, debe ser una función que recibe dos elementos y devuelve true cuando el primer elemento debe venir antes del segundo en el ordenado final.
El error invalid order function for sorting se lanza si ambos comp(a, b) y comp(b, a) devuelven 1> true1> .
Si no se ha dado comp, entonces el operador Lua estándar < se usa en su lugar.
Parâmetros
Devolução
unpack
Devuelve los elementos de la lista dada. Por defecto, i es 1 y j es la longitud de list .
Tenga en cuenta que esta misma funcionalidad también se proporciona por la función global unpack() .