Histórico da Página

Sintaxe

FCLOSE( <expressão numérica> )

Propósito

Fecha um arquivo binário aberto, gravando os buffers no disco.

Argumentos

<expressão numérica>

É o número de manipulação que identifica o arquivo. Esse número é previamente obtido por meio das funções FOPEN() ou FCREATE().

Utilização

A função FCLOSE() é uma função para manipulação de arquivos binários do DOS usada para fechar arquivos que estiverem abertos e forçar a gravação no drive dos buffers associados. Deve ser utilizada em conjunto com as funções FOPEN() e FCREATE().

A função FCLOSE() retorna o valor lógico falso (.F.) caso ocorra algum erro durante a operação de fechamento do arquivo. Caso contrário, retorna o valor lógico verdadeiro (.T.), indicando que a gravação foi bem sucedida.

Dicas

A função FCLOSE() permite o acesso de baixo nível aos arquivos DOS e a outros dispositivos. Por esse motivo deve ser usada com extremo cuidado, requerendo conhecimento detalhado sobre o funcionamento do sistema operacional.

Se ocorrer algum erro durante a operação da função FCLOSE(), pode-se utilizar a função FERROR() para determinar a sua causa.

Exemplos

O exemplo a seguir utiliza FCLOSE() para fechar um arquivo binário recém criado e exibe uma mensagem de erro caso o fechamento falhe:

#include "Protheus.ch"

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

IF !FCLOSE(nHandle)

        MsgAlert("Erro ao fechar arquivo. Erro número: " + STR(FERROR())

ENDIF