FRENAME()

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