Librería (file)
¿Para qué sirve?
Section titled “¿Para qué sirve?”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.
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.
Funciones
Section titled “Funciones”Lee un archivo de texto y devuelve una tabla con las líneas solicitadas.
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
Section titled “Ejemplo”-- 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")Modifica un archivo de texto aplicando string.gsub a todo su contenido.
File_lua: string: La ruta al archivo a modificar....: Una o más tablas{patron, reemplazo}. Cada tabla representa una operacióngsuba realizar.
Ejemplo
Section titled “Ejemplo”-- Reemplaza todas las ocurrencias de "viejo" por "nuevo" en "mi_archivo.txt"file.gsub("mi_archivo.txt", {"viejo", "nuevo"})Comprueba si un patrón de texto existe dentro de un archivo.
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.
Busca todas las ocurrencias de un patrón en un archivo y las devuelve en una tabla.
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.
Cuenta el número total de veces que un patrón aparece en un archivo.
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.
