cArquivoCaractereObrigatório
Origem com extensão e caminho aplicável.
FUNçãOEm revisão
FRename
FRename( cArquivo, cNovoArq, [nParam3], [lChangeCase] ) --> nRetRenomeia e pode mover um arquivo para outro caminho.
Visão geral
FRename retorna zero no sucesso e -1 na falha. A origem deve estar fechada; curingas não são aceitos. Se os diretórios diferirem, a operação move o arquivo, e a ficha restringe combinações entre servidor e estação e execução em JOB. O exemplo GitHub usa caminhos de estação; a adaptação prepara um callback parametrizado sem mover arquivos. Não afirmar que há sobrescrita segura ou movimento atômico: esses contratos não estão estabelecidos na ficha. (TOTVS, s.d., ref. 1)
Sintaxe
FRename( cArquivo, cNovoArq, [nParam3], [lChangeCase] ) --> nRetParâmetros
cNovoArqCaractereObrigatório
Novo nome e destino.
nParam3QualquerOpcional
Compatibilidade: Nil.
lChangeCaseLógicoOpcional
Ajuste de caixa de nomes conforme build/configuração.
Retorno
Zero no sucesso; -1 na falha.
Exemplo comentado
#Include "Protheus.ch"
#Include "Fileio.ch"
User Function Ed395()
Local bRenomear := {|cOrigem,cDestino| FRename(cOrigem,cDestino)}
// Nao avaliar: confirmar arquivos fechados e destino antes de mover.
Return NilResultado esperado
Callback preparado sem renomear ou mover. 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.