Histórico da Página

Sintaxis

FCLOSE(<expresión numérica>)

Propósito

Cierra un archivo binario abierto y graba los buffers en el disco.

Argumentos

<expresión numérica>

El número de manejo es el que permite identificar el archivo. Este número se obtiene previamente por medio de las funciones FOPEN() o FCREATE().

Utilización

La función FCLOSE() es una función para manejar archivos binarios del DOS utilizada para cerrar archivos que estén abiertos y forzar la grabación en el drive de los buffer vinculados. Se debe utilizar juntamente con las funciones FOPEN() y FCREATE().

La función FCLOSE() devuelve el valor lógico falso (.F.) si ocurre algún error durante la operación de cierre del archivo. En caso contrario, devuelve el valor lógico verdadero (.T.), indicando que la grabación tuvo éxito.

Importante

La función FCLOSE() permite el acceso de bajo nivel a los archivos DOS y a otros dispositivos. Por este motivo se debe utilizar con mucho cuidado, lo que requiere un conocimiento detallado sobre el funcionamiento del sistema operativo.

Si ocurre algún error durante la operación de la función FCLOSE(), se puede utilizar la función FERROR() para determinar su causa.

Ejemplos

El siguiente ejemplo utiliza FCLOSE() para cerrar un archivo binario recién creado y muestra un mensaje de error si el proceso de cierre falla:

#include "Protheus.ch"

LOCAL nHandle := FCREATE("Testfile", FC_NORMAL)

IF !FCLOSE(nHandle)

        MsgAlert("Error al cerrar archivo. Error número: " + STR(FERROR())

ENDIF