cArqCaractereObrigatório
Nome com caminho quando necessário.
FUNçãOEm revisão
FOpen
FOpen( cArq, [nModo], [xParam3], [lChangeCase] ) --> nRetAbre um arquivo existente e devolve seu handle.
Visão geral
FOpen não cria um arquivo ausente. nModo combina acesso e compartilhamento definidos em Fileio.ch; o exemplo escolhe somente leitura compartilhada, enquanto o fonte comunitário solicita leitura/escrita. Handle zero é válido e -1 é falha. A busca não segue Set Default/Set Path do AdvPL conforme a ficha, e lChangeCase requer atenção em nomes sensíveis a caixa. O arquivo editorial-test.txt deve existir no contexto de teste; o fragmento fecha apenas seu próprio handle. (TOTVS, s.d., ref. 1)
Sintaxe
FOpen( cArq, [nModo], [xParam3], [lChangeCase] ) --> nRetParâmetros
nModoNuméricoOpcional
Acesso + compartilhamento de Fileio.ch.
xParam3QualquerOpcional
Compatibilidade: Nil.
lChangeCaseLógicoOpcional
Ajuste de caixa de nomes conforme build/configuração.
Retorno
Handle >= 0; -1 em falha.
Exemplo comentado
#Include "Protheus.ch"
#Include "Fileio.ch"
User Function Ed388()
Local nHandle := -1
Local nErro := 0
// Arquivo ficticio existente no contexto de teste; leitura compartilhada.
nHandle := FOpen("editorial-test.txt", FO_READ + FO_SHARED)
If nHandle < 0
nErro := FError()
ConOut(cValToChar(nErro))
Else
ConOut("Arquivo aberto para leitura")
If !FClose(nHandle)
ConOut(cValToChar(FError()))
EndIf
EndIf
Return NilResultado esperado
Mensagem de abertura seguida de fechamento, ou código de falha. 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.