Librería (table)

Autortrotacalles

¿Para qué sirve?

Esta librería expande enormemente las capacidades de las tablas estándar de Lua. No solo ofrece herramientas para manipular y consultar tablas, sino que también incluye funciones avanzadas para procesar datos, generar secuencias y realizar operaciones complejas que son fundamentales para la creación de efectos dinámicos.

Funciones

Funciones de inspección e información

Muestra el contenido completo de una tabla en un formato de texto legible. Invaluable para depurar.

Comprueba si un elemento, tipo de elemento (number, string) o patrón de texto existe dentro de una tabla. Devuelve true o false.

Devuelve el índice (la posición) del primer elemento que coincida con la búsqueda.

Compara dos tablas de forma profunda para ver si son idénticas en contenido y estructura.

Analiza el contenido de una tabla y determina un tipo general para sus elementos, como number, string, shape, color, etc.

Comprueba si un elemento, tipo de elemento (number, string) o patrón de texto existe dentro de una tabla. Devuelve true o false.

Ejemplo

local cantidad_numeros = table.count({1, "a", 2}, "number") -- Devuelve: 2

Devuelve una tabla con todos los índices en los que se encuentra un elemento, tipo o patrón.

Ejemplo

local posiciones = table.pos({"a", "b", "a"}, "a") -- Devuelve: {1, 3}

Funciones de manipulación y modificación

Crea una copia exacta y profunda de una tabla. Crucial para modificar una tabla sin alterar la original.

Desordena aleatoriamente los elementos de una tabla.

Elimina elementos de una tabla por su índice o por un rango de índices.

Invierte el orden de los elementos de una tabla.

Crea una tabla cíclica (palíndromo sin el último elemento). {a, b, c, d} se convierte en {a, b, c, d, c, b}.

Inserta todos los elementos de Table2 dentro de Table1 en una posición específica.

Aplica string.gsub a todos los elementos de tipo string dentro de una tabla.

Elimina los elementos duplicados de una tabla, dejando solo una aparición de cada uno.

Ejemplo

table.unique({1, 2, 2, 3}) -- Devuelve: {1, 2, 3}

Convierte una tabla con claves no numéricas (asociativa) en una tabla indexada (un array), descartando las claves.

Ejemplo

table.ipairs({a="rojo", b="verde"}) -- Devuelve: {"rojo", "verde"}

Agrupa los elementos de una tabla en sub-tablas de un tamaño determinado.

Ejemplo

table.inpack({1,2,3,4,5,6}, 2) -- Devuelve: {{1,2}, {3,4}, {5,6}}

Filtra una tabla, devolviendo solo los elementos que cumplen una condición definida por una función de filtro. Es la contraparte de table.match, pero en lugar de buscar un valor, evalúa una condición lógica.

Ejemplo

-- Define un filtro que solo acepta números impares.
local filtro_impares = function(k, v)
    if v % 2 == 1 then
        return true
    end
    return false
end

-- Aplica el filtro a una tabla.
local mi_tabla = {1, 2, 3, 4, 5, 6}
local tabla_filtrada = table.filter(mi_tabla, filtro_impares) -- Devuelve {1, 3, 5}

Funciones de combinación y creación

Funciones avanzadas para combinar tablas de diferentes maneras, creando permutaciones y emparejamientos. Se recomienda experimentar para entender su salida.

Genera todas las combinaciones posibles de n elementos a partir de una tabla.

Ejemplo

table.inpack({1,2,3,4,5,6}, 2) -- Devuelve: {{1,2}, {3,4}, {5,6}}

Genera todas las permutaciones (órdenes) posibles de los elementos de una tabla.

Crea una tabla de un tamaño específico, llenando cada posición con un valor o una copia de una tabla.

Repite un conjunto de elementos un número determinado de veces para crear una tabla más grande.

Ejemplo

table.replay(3, "a", "b") -- Devuelve: {"a", "b", "a", "b", "a", "b"}

Divide una cadena de texto en una tabla de sub-cadenas, cada una con una longitud de n caracteres.

Ejemplo

table.string("abcdef", 2) -- Devuelve {"ab", "bc", "cd", "de", "ef"}

Realiza una búsqueda global (gmatch) sobre un texto y devuelve todas las capturas en una tabla.

Ejemplo

table.capture("hola 123 mundo", "%d+") -- Devuelve: {"123"}

Devuelve una nueva tabla que contiene solo los elementos de la tabla original que coinciden con el valor, tipo o patrón de búsqueda.

Funciones de procesamiento avanzado

Una función “multiherramienta” que realiza diversas operaciones matemáticas o de ordenamiento sobre una tabla.

Interpola valores entre los elementos de una tabla. Puede interpolar números, colores, alfas, shapes y clips. Es fundamental para animaciones suaves.

Filtra una tabla, devolviendo solo los elementos que cumplen una condición definida por una función.

Una función “multiherramienta” que realiza diversas operaciones matemáticas o de ordenamiento sobre una tabla.

Versión de remember para tablas. Guarda múltiples pares de referencia-valor en la tabla recall de una sola vez.

InicioVolver a la biblioteca de funciones