STRUCT fileinfo;
string fullpath[254]; // Nombre completo
drive; // Unidad de disco
string dir[254]; // Directorio
string name[7]; // Nombre
string ext[3]; // Extensión
size; // Tamaño (en bytes)
day; // Día
month; // Mes
year; // Año
hour; // Hora
min; // Minuto
sec; // Segundo
attrib; // Atributos
END
Esta estructura global predefinida se utiliza como retorno de la función get_fileinfo(), para contener los atributos de un archivo (o subdirectorio).
Se trata de una estructura de un único registro, que agrupa varias cadenas de texto (datos de tipo STRING) y variables numéricas (datos de tipo INT).
Se muestra a continuación una descripción detallada de cada campo
fullpath - Nombre completo (incluyendo la ruta). 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.
drive - Unidad de disco en la que se encuentra el archivo sobre el que se ha solicitado información. La unidad no se devuelve como la letra correspondiente, sino como un número, estableciéndose la siguiente correspondencia: 1 para A:, 2 para B:, 3 para C:, etc.
dir - Directorio donde se encuentra el archivo. En esta cadena no se devuelve únicamente el nombre de la carpeta que contiene al archivo, sino que se especifica la ruta completa, a partir del directorio raiz pasando por todos los directorios (por ejemplo "\DIV\MAP\"). Siempre se devolverá con una barra invertida (\) al inicio y otra al final.
name - Nombre del archivo, este campo (fileinfo.name), retorna el nombre del archivo, sin extensión, de un máximo de 8 carácteres.
ext - Extensión del archivo. Como última parte del nombre se retorna en este campo la extensión del archivo, en una cadena que incluye el punto que separa el nombre de la misma.
size - Tamaño del archivo, este valor será 0 si se solicita información sobre un directorio. El tamaño se retorna como el número de datos simples, es decir, como el número de datos de tipo INT que caben en el archivo (número de bytes entre cuatro). Es posible variar esta relación modificando la variable global unit_size).
day - Día del mes de la última actualización del archivo.
month - Mes de la última actualización del archivo.
year - Año de la última actualización del archivo.
hour - Hora de la última actualización (de 0 a 23).
min - Minuto dentro de la hora.
sec - Segundo dentro del minuto.
attrib - Atributos del archivo, estos indican las características del archivo, tales como si es un archivo de sistema, sólo de lectura, oculto, etc. Este valor es la suma de las siguientes constantes:
0 - Archivo normal.
1 - Archivo de sólo lectura.
2 - Archivo oculto.
4 - Archivo de sistema.
8 - Etiqueta de volumen.
16 - Subdirectorio.
32 - Marcha de archivo.
Por ejemplo, para un archivo de sistema y oculto, el valor de fileinfo.attrib sería 6 (2 Oculto + 4 Sistema).