Esta librería proporciona capacidades de entrada/salida (I/O) de archivos. Permite leer, modificar y analizar archivos de texto directamente desde un script de Kara Effector. Es una herramienta avanzada, útil para efectos que necesitan importar datos externos (como coordenadas, configuraciones, o texto) o para crear scripts que modifican otros archivos.
Nota de Seguridad: Estas funciones modifican archivos en tu disco duro. Úsalas con precaución y asegúrate de tener copias de seguridad de los archivos que planeas modificar.
file.get_lines( File_lua, Number_or_match )Descripción: Lee un archivo de texto y devuelve una tabla con las líneas solicitadas.
Argumentos:
File_lua (string): La ruta al archivo a leer.Number_or_match (number | table | string, opcional): Especifica qué líneas leer.
number: El número de una línea específica.table: Un rango {linea_inicio, linea_fin} o una tabla de números de línea {{n1, n2, ...}}.string: Un patrón de LUA. Devuelve todas las líneas que coincidan con el patrón."r": Lee todas las líneas del archivo.Ejemplo de Uso:
-- Lee la línea 5 del archivo "config.txt"
linea_5 = file.get_lines("config.txt", 5)
-- Lee todas las líneas que contienen la palabra "coordenadas"
lineas_coord = file.get_lines("config.txt", "coordenadas")
file.gsub( File_lua, ... )Descripción: Modifica un archivo de texto aplicando string.gsub a todo su contenido. Esta acción sobrescribe el archivo original.
Argumentos:
File_lua (string): La ruta al archivo a modificar....: Una o más tablas {patron, reemplazo}. Cada tabla representa una operación gsub a realizar.Ejemplo de Uso:
-- Reemplaza todas las ocurrencias de "viejo" por "nuevo" en "mi_archivo.txt"
file.gsub("mi_archivo.txt", {"viejo", "nuevo"})
file.match( File_lua, Match_or_tbl )Descripción: Comprueba si un patrón de texto existe dentro de un archivo.
Argumentos:
File_lua (string): La ruta al archivo a buscar.Match_or_tbl (string | table): Un patrón de LUA o una tabla de patrones a buscar.Devuelve: true si se encuentra al menos una coincidencia, false en caso contrario.
file.gmatch( File_lua, Match_or_tbl )Descripción: Busca todas las ocurrencias de un patrón en un archivo y las devuelve en una tabla.
Argumentos:
File_lua (string): La ruta al archivo.Match_or_tbl (string | table): Un patrón de LUA o una tabla de patrones.Devuelve: Una tabla con todas las coincidencias encontradas.
file.count( File_lua, Match_or_tbl )Descripción: Cuenta el número total de veces que un patrón aparece en un archivo.
Argumentos:
File_lua (string): La ruta al archivo.Match_or_tbl (string | table): El patrón o tabla de patrones a contar.Devuelve: Un número con el total de coincidencias.