int get_fileinfo( const char * 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:

 fullname // Nombre completo (incluyendo la ruta).
 size     // Tamaño (en datos simples).
 day      // Día (fecha de última actualización).
 weekday  // Día de la semana (fecha de última actualización).
 yearday  // Día del año (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().

MAIN_PROGRAM_CDIV
BEGIN_PROGRAM
    // ...

    get_fileinfo("../HELP.FPG");

    // ...
END_PROGRAM

Este pequeño ejemplo solicita información sobre el fichero help.fpg.

Para abrir o crear un archivo se puede utilizar la función fopen(), y para borrar un archivo existente en el disco se utiliza delete_file().

Ver: get_dirinfo() - fopen() - delete_file()