Árvore de páginas

Você está vendo a versão antiga da página. Ver a versão atual.

Comparar com o atual Ver Histórico da Página

« Anterior Versão 2 Próxima »

Função: FClose

Fecha um arquivo binário aberto e escreve buffers de disco no DOS - Disk Operating System.

FClose ( [ nHandle] ) --> lRet

NomeTipoDescriçãoObrigatórioReferência
nHandleNuméricoIndica handle do arquivo obtido, previamente, através da função FOpen() ou FCreate().
    lRet(logico)
  • Retorna falso (.F.), se ocorrer um erro enquanto os buffers estão sendo escritos; caso contrário, verdadeiro (.T.).

Essa função é de tratamento de arquivos de baixo nível utilizada para fechar arquivos binários e forçar que os respectivos buffers do DOS - Disk Operating System sejam escritos no disco. No entanto, caso a operação falhe, a função retornará falso (.F.).

Neste caso, pode-se utilizar a função FError() para determinar a razão exata da falha. Por exemplo, ao tentar usar FClose() com um handle (tratamento dado ao arquivo pelo sistema operacional) inválido retorna falso (.F.) e FError() retorna o erro 6 do DOS, invalid handle.

Importante
Esta função permite acesso de baixo nível a arquivos e dispositivos DOS - Disk Operating System (sistema operacional de disco). Desta forma, recomenda-se muita cautela na utilização e um conhecimento detalhado do sistema operacional.

 

// Fecha 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)	   conout( "Erro ao fechar arquivo, erro numero: ", FERROR() )EndIf
Advanced Protheus 6.09 , Advanced Protheus 7.10 , Microsiga Protheus 8.11 , Protheus 10 , TOTVS Application Server 10 , ByYou Application Server

  • Sem rótulos