files : Manejo del sistema de archivos.

Funciones
nil	files.cdir (string path)
	Cambia la carpeta de trabajo actual a la especificada.
string	files.cdir ()
	Devuelve la carpeta de trabajo actual.
table	files.list (string path)
	Lista un directorio.
table	files.listfiles (string path)
	Lista un directorio, mostrando sólo los archivos.
table	files.listdirs (string path)
	Lista un directorio, mostrando sólo las carpetas.
nil	files.mkdir (string path)
	Crea una carpeta.
nil	files.remove (string path)
	Elimina un archivo o carpeta.
nil	files.remove (string path, boolean recursive)
	Elimina un archivo o carpeta.
nil	files.copy (string source, string dest)
	Copia un archivo o carpeta.
nil	files.copy (string source, string dest, boolean recursive)
	Copia un archivo o carpeta. Recursivo.
nil	files.copy (string source, string dest, boolean recursive, boolean overwrite)
	Copia un archivo o carpeta. Recursivo.
nil	files.rename (string name, string newname)
	Renombra un archivo / carpeta.
boolean	files.exists (string path)
	Determina si existe un archivo / carpeta.
string	files.nopath (string path)
	Quita la carpeta a una ruta.
string	files.nofile (string path)
	Quita el archivo a una ruta.
string	files.ext (string path)
	Devuelve la extensión en minúsculas.
number	files.size (string path)
	Tamaño de un archivo. En bytes.
string	files.sizeformat (number bytes)
	Da formato a un tamaño de archivo.
int	files.freespace ()
	Espacio libre de la memory stick.
int	files.totalspace ()
	Espacio total de la memory stick.

---

Descripción detallada

En este módulo se incorporan todas las funciones relacionadas con el manejo de archivos.

Este módulo trabaja bajo el hipervisor de LuaDEV. Es decir, sólo puede trabajar de manera normal, dentro de la carpeta en la que se encuentre el EBOOT (su espacio de trabajo). Fuera de este espacio, requerirá el consentimiento del usuario para poder modificar archivos. (Accediendo en sólo lectura no requiere permiso).

---

Documentación de las funciones

nil files.cdir

(

string

path

)

Cambia la carpeta de trabajo actual a la especificada.

Parámetros:

path

La ruta de la nueva carpeta de trabajo.

Devuelve:

Nada.

string files.cdir

(

)

Devuelve la carpeta de trabajo actual.

Devuelve:

Una string, con la carpeta actual.

table files.list

(

string

path

)

Lista un directorio.

Parámetros:

path

La carpeta a listar. Si no se especifica, se listará la actual.

Devuelve:

Una tabla, con sus entradas listadas numéricamente.
Cada entrada, será una tabla con las siguientes claves:

• "name" (string) La ruta completa del archivo.
• "size" (number) Su tamaño en bytes.
• "ctime" (table) Tabla con la fecha de creación del archivo.
• "atime" (table) Tabla con la fecha del último acceso.
• "mtime" (table) Tabla con la fecha de la última modificación del archivo.
• "directory" (boolean) Indica si la entrada es un directorio o no.

Las tablas con las fechas, són tablas con los siguientes campos:

• "day" (number) Día.
• "month" (number) Mes.
• "year" (number) Año.
• "hour" (number) Hora.
• "minute" (number) Minutos.
• "second" (number) Segundos.

No se tendrán en cuenta los archivos "." y ".."

table files.listfiles

(

string

path

)

Lista un directorio, mostrando sólo los archivos.

Parámetros:

path

La carpeta a listar. Si no se especifica, se listará la actual.

Devuelve:

Una tabla, con el mismo formato que files.list() pero sin "carpetas".

table files.listdirs

(

string

path

)

Lista un directorio, mostrando sólo las carpetas.

Parámetros:

path

La carpeta a listar. Si no se especifica, se listará la actual.

Devuelve:

Una tabla, con el mismo formato que files.list() pero sin "archivos".

nil files.mkdir

(

string

path

)

Crea una carpeta.

Parámetros:

path

La ruta a la carpeta a crear.

Devuelve:

Nada.

nil files.remove

(

string

path

)

Elimina un archivo o carpeta.

Sólo puede eliminar carpetas que estén vacías.

Parámetros:

path

La ruta del archivo / carpeta a borrar.

Devuelve:

Nada.

nil files.remove	(	string	path,
		boolean	recursive
	)

Elimina un archivo o carpeta.

Si se especifica recursive como true, y la ruta a eliminar es un directorio, éste se eliminará de manera recursiva, es decir, primero se vaciará y luego se eliminará. Además, si hay más carpetas dentro de ésta, también serán vaciadas y eliminadas. Si no se especifica como recursive, esta función sólo puede eliminar directorios que estén completamente vacíos.

Parámetros:

	path	La ruta del archivo / carpeta a borrar.
	recursive	Eliminar de manera recursiva. (true = recursivo, false = no recursivo )

Devuelve:

Nada.

nil files.copy	(	string	source,
		string	dest
	)

Copia un archivo o carpeta.

Copiar archivos o carpetas. No recursivo. No sobreescribe.

Parámetros:

	source	La ruta del archivo / carpeta a copiar.
	dest	La ruta del archivo / carpeta de destino.

Devuelve:

Nada.

nil files.copy	(	string	source,
		string	dest,
		boolean	recursive
	)

Copia un archivo o carpeta. Recursivo.

Copia un archivo o una carpeta. Recursivo, copia todos los contenidos de todas las carpetas de la ruta source, a la ruta dest. No sobreescibe.

Parámetros:

	source	La ruta del archivo / carpeta a copiar.
	dest	La ruta del archivo / carpeta de destino.
	recursive	Copiar de manera recursiva. (true = recursivo, false = no recursivo )

Devuelve:

Nada.

nil files.copy	(	string	source,
		string	dest,
		boolean	recursive,
		boolean	overwrite
	)

Copia un archivo o carpeta. Recursivo.

Copia un archivo o una carpeta. Recursivo, copia todos los contenidos de todas las carpetas de la ruta source, a la ruta dest. Sobreescribe los archivos en la carpeta destino.

Parámetros:

	source	La ruta del archivo / carpeta a copiar.
	dest	La ruta del archivo / carpeta de destino.
	recursive	Copiar de manera recursiva. (true = recursivo, false = no recursivo )
	overwrite	Sobreescribir. (true = si, false = no )

Devuelve:

Nada.

nil files.rename	(	string	name,
		string	newname
	)

Renombra un archivo / carpeta.

Parámetros:

	name	Archivo / carpeta a renombrar.
	newname	Nuevo nombre

Devuelve:

Nada.

boolean files.exists

(

string

path

)

Determina si existe un archivo / carpeta.

Parámetros:

path

Ruta al archivo / carpeta.

Devuelve:

True / false, según si existe o no el archivo o carpeta especificada.

string files.nopath

(

string

path

)

Quita la carpeta a una ruta.

Ejemplo: "ms0:/PSP/GAME/bla/archiv.txt" --> "archiv.txt"

Parámetros:

path

Ruta al archivo / carpeta.

Devuelve:

El nombre del archivo completo.

string files.nofile

(

string

path

)

Quita el archivo a una ruta.

Ejemplo: "ms0:/PSP/GAME/bla/archiv.txt" --> "ms0:/PSP/GAME/bla/"

Parámetros:

path

Ruta al archivo / carpeta.

Devuelve:

El nombre de la ruta sin el archivo.

string files.ext

(

string

path

)

Devuelve la extensión en minúsculas.

Ejemplo: "ms0:/PSP/GAME/bla/archiv.txt" --> "txt"

Realmente són las 3 últimas letras del texto pasado, en minúsculas.

Parámetros:

path

Ruta al archivo / carpeta.

Devuelve:

La extensión en minúsculas del archivo.

number files.size

(

string

path

)

Tamaño de un archivo. En bytes.

Parámetros:

path

Ruta al archivo.

Devuelve:

El número de bytes.

string files.sizeformat

(

number

bytes

)

Da formato a un tamaño de archivo.

Parámetros:

bytes

Número de bytes.

Devuelve:

Una string, con el tamaño y la unidad. (Ejemplo: "3.43 MB")

int files.freespace

(

)

Espacio libre de la memory stick.

Devuelve:

Devuelve el espacio libre de la memory stick en bytes.

int files.totalspace

(

)

Espacio total de la memory stick.

Devuelve:

Devuelve el espacio total de la memory stick en bytes.