Función FILEINFO

Sintaxis

FILEINFO ( variable.archivo ,  clave)

El valor de variable.archivo es la variable de archivo de un archivo abierto.

El valor de clave es un número que indica la información concreta necesaria. Estos números de clave se describen en la tabla Claves y valores suministrados a la función FILEINFO.

Descripción

Utilice la función FILEINFO para devolver información sobre la configuración del archivo especificado, como los parámetros, el módulo y la carga, el nombre de archivo del sistema operativo y el nombre VOC. La información devuelta depende del tipo de archivo y el valor de la clave.

Si el primer argumento no es una variable de archivo, todas las claves excepto 0 devuelven una serie vacía. También se visualiza un mensaje de aviso. Se genera un error muy grave si se suministra una clave que no es válida.

Nombres de equivalencia de claves

Se proporciona un archivo de inserción de nombres de equivalencia para permitir al usuario emplear mnemónicos en lugar de números de clave. El archivo de inserción, denominado FILEINFO.INS.IBAS, se encuentra en el directorio INCLUDE del directorio de la cuenta UV. En las cuentas de tipo PIOPEN se hace referencia a él mediante un puntero de archivo VOC denominado SYSCOM. Utilice la sentencia $INCLUDE para insertar este archivo si desea utilizar los nombres de equivalencia, como se muestra en el ejemplo. La tabla siguiente muestra el nombre simbólico, el valor y la descripción:

Valor devuelto por la función STATUS

Si la función se ejecuta correctamente, el valor devuelto por la función STATUS es 0. Si la función no se ejecuta correctamente, STATUS devuelve un valor distinto de cero. La tabla siguiente muestra la clave, el tipo de archivo y el valor devuelto para clave:

^{1Los valores devueltos para los archivos distribuidos son matrices dinámicas con el valor adecuado para archivo componente. Los valores individuales dependen del tipo de archivo del archivo componente. Por ejemplo, si el archivo componente es un archivo hash, algunos valores, como el módulo mínimo, tienen un valor vacío en la matriz dinámica para ese archivo componente.}

Modalidad de soporte multilingüístico

La función FILEINFO determina el nombre de correlación de un archivo utilizando el valor de FINFO$NLSMAP. El soporte multilingüístico utiliza el archivo de inserción denominado FILEINFO.H.

Ejemplos

En el ejemplo siguiente, se inserta el archivo que contiene los nombres de equivalencia de claves con la sentencia $INCLUDE. Se abre el archivo FILMS y se visualiza su tipo de archivo.

$INCLUDE SYSCOM FILEINFO.INS.IBAS
OPEN '','FILMS' TO FILMS
        ELSE STOP 'CANT OPEN FILE'
PRINT FILEINFO(FILMS,FINFO$TYPE)

En el ejemplo siguiente, se abre el archivo FILMS y se visualiza su tipo de archivo al especificar la clave numérica:

OPEN '','FILMS' TO FILMS
        ELSE STOP 'CANT OPEN FILE'
PRINT FILEINFO(FILMS,3)