Usina BRAdvPL Guia
Entrar
← Todos os tópicos
FUNçãOEm revisão

FError

FError() --> nRet

Recupera o diagnóstico da última operação de arquivo.

FErrorAdvPL
01 · VISÃO GERAL

Visão geral

FError retorna um código da última operação de arquivo, com zero para ausência de erro. Capture o código imediatamente após a falha; fechar outro handle antes pode mudar a referência do diagnóstico. A lista oficial contém descrições dependentes de plataforma, portanto não interpretar um número como errno universal. O exemplo força fechamento de handle inválido -1, sem tocar um arquivo válido. A ficha FClose confirma esse caso, mas não se fixa aqui um código numérico portátil. (TOTVS, s.d., ref. 1)

02 · SINTAXE

Sintaxe

FError() --> nRet

Retorno

Código numérico; zero indica ausência de erro.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"
#Include "Fileio.ch"

User Function Ed381()
    Local nErro
    // -1 nao e um handle valido; consultar diagnostico imediatamente.
    If !FClose(-1)
        nErro := FError()
        ConOut(cValToChar(nErro))
    EndIf
Return Nil
Resultado esperado

Código de falha conforme implementação; nenhum handle válido fechado. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • 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.

Conteúdos relacionados

REFERÊNCIAS
  1. TOTVS. FError. TDN. Consulta em 2026-10-26.
  2. TOTVS. FClose. TDN. Consulta em 2026-10-26.
  3. EURAI. ADVPL/Funcoes/Arquivos de Disco/FError.PRW. universo_do_desenvolvedor_site, commit a5c83e9490302bdb4a0fc5a9d92c2d569a60773c. Exemplo analisado. Consulta em 2026-10-26.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR
0 comentário(s) aprovado(s)

Comentários

Ainda não há comentários aprovados.

Entre com Google ou Microsoft para comentar.

Powered by Usina Docs · Alpha