FCLOSE()
 Fecha um arquivo binário aberto e escreve buffers de disco no DOS
------------------------------------------------------------------------------

 Sintaxe

     FCLOSE(<nHandle>) --> lError

 Argumentos

     <nHandle> é o handle do arquivo obtido previamente através de
     FOPEN() ou FCREATE().

 Retorno

     FCLOSE() retorna falso (.F.) se ocorre um erro enquanto os buffers
     estao sendo escritos; do contrário, retorna verdadeiro (.T.).

 Descriçao

     FCLOSE() é uma funçao de tratamento de arquivos de baixo nível
     utilizada para fechar arquivos binários e forçar que os respectivos
     buffers do DOS sejam escritos no disco.  Caso a operaçao falhe,
     FCLOSE() retorna falso (.F.).  FERROR() pode entao ser usado para
     determinar a razao exata da falha.  Por exemplo, ao tentar-se usar
     FCLOSE() com um handle (tratamento dado ao arquivo pelo sistema
     operacional) inválido retorna falso (.F.) e FERROR() retorna erro 6 do
     DOS, invalid handle.  Consulte FERROR() para obter uma lista completa
     dos códigos de erro.

     -----------------------------------------------------------------------
     . Aviso

     Esta funçao permite acesso de baixo nível aos arquivos e dispositivos
     do DOS.  Ela deve ser utilizada com extremo cuidado e exige que se
     conheça a fundo o sistema operacional.
     -----------------------------------------------------------------------

 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 "Fileio.ch"
     //
     nHandle := FCREATE("Testfile", FC_NORMAL)
     IF !FCLOSE(nHandle)
        ? "Erro ao fechar arquivo, erro numero: ", FERROR()
     ENDIF

 Arquivos:  Biblioteca CLIPPER.LIB.
 To download this example - click here.

See Also: FCREATE() FERROR() FOPEN()