Usina BRGuía AdvPL
Ingresar
← Todos los temas
FUNCIóNEn revisión

FRename

FRename( cArquivo, cNovoArq, [nParam3], [lChangeCase] ) --> nRet

Renombra archivo y puede moverlo a otra ruta.

FRenameAdvPL
01 · DESCRIPCIÓN GENERAL

Descripción general

FRename devuelve cero al éxito y -1 al fallo. Origen cerrado y sin comodines. Directorios distintos implican movimiento, con restricciones servidor/estación y JOB. GitHub usa rutas de estación; adaptación prepara callback sin mover archivos. Ficha no establece sobrescritura segura ni movimiento atómico. (TOTVS, s.f., ref. 1)

02 · SINTAXIS

Sintaxis

FRename( cArquivo, cNovoArq, [nParam3], [lChangeCase] ) --> nRet

Parámetros

cArquivo
CarácterObligatorio

Origen con extensión y ruta.

cNovoArq
CarácterObligatorio

Nuevo nombre/destino.

nParam3
CualquieraOpcional

Compatibilidad: Nil.

lChangeCase
LógicoOpcional

Ajuste de mayúsculas según build/configuración.

Retorno

Cero al éxito; -1 al fallo.

03 · EJEMPLO PRÁCTICO

Ejemplo comentado

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

User Function Ed395()
    Local bRenombrar := {|cOrigen,cDestino| FRename(cOrigen,cDestino)}
    // No evaluar: comprobar archivos cerrados y destino antes de mover.
Return Nil
Resultado esperado

Callback preparado sin renombrar ni mover. En revisión: ejemplo editorial no compilado ni ejecutado en Protheus. Comprobar includes, release, RDD y contexto antes de probar.

BUENAS PRÁCTICAS
  • Comprobar ruta, permisos, plataforma y propiedad del handle. Cerrar solo handles propios, incluido manejo de errores de aplicación completa.
  • En revisión: ejemplo editorial no compilado ni ejecutado en Protheus. Comprobar includes, release, RDD y contexto antes de probar.

Contenido relacionado

REFERENCIAS
  1. TOTVS. FRename. TDN. Consulta el 2026-10-26.
  2. EURAI. ADVPL/Funcoes/Arquivos de Disco/FRename.PRW. universo_do_desenvolvedor_site, commit a5c83e9490302bdb4a0fc5a9d92c2d569a60773c. Exemplo analisado. Consulta el 2026-10-26.
Estado
En revisión
Página creada el
Última revisión el
Idioma original
Portugués
Revisión
Usina.BR
0 comentario(s) aprobado(s)

Comentarios

Todavía no hay comentarios aprobados.

Inicia sesión con Google o Microsoft para comentar.

Desarrollado con Usina Docs · Alpha