get_fileinfo(<nombre de archivo>)
Retorna:
0 - No se pudo obtener información sobre el archivo.
1 - La información del archivo se guardó correctamente.
Descripción:
Obtiene información sobre un archivo o directorio del disco, para ello, la función requiere el <nombre del archivo> como parámetro (entre comillas). Se puede indicar únicamente el nombre, o incluir además la ruta de acceso al mismo.
Si la función encuentra dicho archivo en el directorio especificado (o en el actual, en caso de no especificar ninguno), retornará 1 y guardará toda la información sobre el archivo en la estructura global fileinfo, que contiene los siguientes campos:
fullpath - Nombre completo (incluyendo la ruta).
drive - Unidad de disco (1-A:, 2-B:, 3-C:, ...).
dir - Directorio del archivo.
name - Nombre del archivo.
ext - Extensión del archivo.
size - Tamaño (en datos simples, ver unit_size).
day - Día (fecha de última actualización).
month - Mes (fecha de última actualización).
year - Año (fecha de última actualización).
hour - Hora (hora de última actualización).
min - Minuto (hora de última actualización).
sec - Segundo (hora de última actualización).
attrib - Atributos del archivo.
La ruta de acceso al archivo se puede especificar completa (a partir del directorio raiz de la unidad, como "C:\WINDOWS\...") o relativa al directorio actual (a partir de donde se ejecute el juego, como "MAP\MIOS\..."). En cualquier caso, en fileinfo.fullpath siempre se devolverá la ruta completa a partir del directorio raiz, incluyendo la letra de la unidad.
La función get_fileinfo() únicamente obtiene información sobre un archivo, para obtener la lista completa de archivos de un directorio, se debe utilizar la función get_dirinfo().
PROGRAM ejemplo_get_fileinfo; BEGIN // ... get_fileinfo("HELP\HELP.FPG"); // ... END
Este pequeño ejemplo solicita información sobre el fichero help.fpg contenido en el directorio help. Se puede extraer y trazar (con F12) para observar como, tras llamar a la función, la estructura global predefinida fileinfo se ha rellenado con todos los datos del archivo.
Para abrir o crear un archivo se puede utilizar la función fopen(), y para borrar un archivo existente en el disco se utiliza remove().
La función disk_free() permite averiguar el espacio libre que queda en una unidad de disco.