file.rename( )

4D v19.8

file.rename( )


file.rename ( nuevoNombre ) -> Resultado

Parámetro	Tipo	Descripción
nuevoNombre	Texto	Nuevo nombre completo para el archivo
Resultado	Objeto	Archivo renombrado

Descripción

El método file.rename( ) cambia el nombre del archivo por el nombre que paso en nuevoNombre y devuelve el objeto renombrado File.

El parámetro nuevoNombre debe cumplir con las reglas de denominación (por ejemplo, no debe contener caracteres como ":", "/", etc.), de lo contrario se devuelve un error. Si ya existe un archivo con el mismo nombre, se devuelve un error.

Tenga en cuenta que el método modifica el nombre completo del archivo, es decir, si no pasa una extensión en nuevoNombre, el archivo tendrá un nombre sin una extensión.

Objeto devuelto

El método devuelve el objeto renombrado File.

Ejemplo

Desea cambiar el nombre de "ReadMe.txt" por "ReadMe_new.txt":

 $toRename:=File("C:\\Documents\\Archives\\ReadMe.txt";fk platform path)

 $newName:=$toRename.rename($toRename.name+"_new"+$toRename.extension)