nHandleNuméricoOpcional
Handle válido a fechar; fornecido explicitamente no exemplo.
FUNçãOEm revisão
FClose
FClose( [nHandle] ) --> lRetFecha um handle de arquivo pertencente à rotina.
Visão geral
FClose retorna verdadeiro no fechamento e falso na falha; FError precisa ser consultado após a falha para obter detalhe. Um handle de arquivo não é alias de tabela. O exemplo comunitário cria um arquivo antes de fechar; a adaptação abre um arquivo de teste existente somente para leitura, verifica inclusive handle zero e fecha no caminho normal. A ausência do arquivo produz diagnóstico de abertura, sem criar substituto. (TOTVS, s.d., ref. 1)
Sintaxe
FClose( [nHandle] ) --> lRetParâmetros
Retorno
Lógico de sucesso do fechamento.
Exemplo comentado
#Include "Protheus.ch"
#Include "Fileio.ch"
User Function Ed378()
Local nHandle := FOpen("editorial-test.txt", FO_READ + FO_SHARED)
// Handle zero e valido; nao usar teste maior que zero.
If nHandle >= 0
If !FClose(nHandle)
ConOut(cValToChar(FError()))
EndIf
Else
ConOut(cValToChar(FError()))
EndIf
Return NilResultado esperado
Fecha se a abertura for bem-sucedida; falhas são informadas pelo código, sem conteúdo de arquivo. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.
- Conferir caminho, permissões, plataforma e propriedade do handle. Fechar somente handles obtidos pela própria rotina, inclusive em tratamento de erros da aplicação completa.
- Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.
Comentários
Ainda não há comentários aprovados.
Entre com Google ou Microsoft para comentar.