TOTVSTEC

Árvore de páginas

Fecha um arquivo binário aberto

Sintaxe

FClose( [ nHandle ] )

Parâmetros

Nome

Tipo

Descrição

Obrigatório

Referência

nHandle

numérico

Indica handle do arquivo obtido previamente, através da função FOpen() ou FCreate().



Retorno

Nome

Tipo

Descrição

lRet

lógico

Se ocorrer um erro ao fechar o arquivo retorna falso (.F.), caso contrário retorna verdadeiro (.T.).

Observações

  • Essa função é de tratamento de arquivos de baixo nível utilizada para fechar arquivos binários. 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, invalid handle.

Exemplos

// Fecha um arquivo binário recém criado e exibe uma mensagem de erro caso o fechamento falhe
#include "Fileio.ch"
User function exemplo()
  nHandle := FCREATE("Testfile", FC_NORMAL)

  If !FCLOSE(nHandle)
    conout( "Erro ao fechar arquivo, erro numero: ", FERROR() )
  EndIf
return

Veja também

  • Sem rótulos