Sintaxis
FRENAME( <nombre antiguo>, <nombre nuevo> )
Propósito
Modifica el nombre de un archivo.
Argumentos
< nombre antiguo>
Es el nombre original del archivo que se renombrará, incluyendo su extensión. La identificación del drive y la designación de la carpeta también deben incluirse si el archivo no está en la carpeta actual.
< nombre nuevo>
Es el nuevo nombre atribuido al archivo, incluyendo su extensión. La identificación del drive y la designación de la carpeta también deben incluirse si el archivo no está en la carpeta actual.
Utilización
En caso de que no se ubique en la misma carpeta, la otra carpeta debe informarse como parte del nuevo nombre. Después del cambio del nombre, si la carpeta original del archivo es diferente de la nueva carpeta, el archivo se moverá de carpeta.
Si ya existe un archivo con el nuevo nombre especificado en la misma carpeta, o si el archivo que se renombrará está abierto, la función FRENAME() no ejecutará la operación y suministrará el valor -1. En este caso, la función FERROR() podrá utilizarse para determinar la modalidad del error ocurrido.
Sugerencias
Cualquier archivo que se renombrará por medio de la función FRENAME() debe estar obligatoriamente cerrado antes de tener el nombre cambiado. El cambio del nombre de un archivo abierto puede ocasionar resultados imprevisibles.
Ejemplos
El siguiente ejemplo muestra cómo modificar el nombre de un archivo:
IF FRENAME("OldFile.txt", "NewFile.txt") = -1
MsgAlert("Error en la operación: " + STR(FERROR()))
BREAK
ENDIF