RENAME
 Cambia el nombre de un fichero
------------------------------------------------------------------------------
 Sintaxis

     RENAME <xcFichAnterior> TO <xcFichNuevo>

 Argumentos

     <xcFichAnterior> es el nombre del fichero cuyo nombre se va a
     cambiar, incluyendo la extensión y precedido, opcionalmente, por un
     indicador de vía y/o unidad. <xcFichAnterior> puede ser una cadena de
     caracteres en forma literal o una expresión de caracteres encerrada
     entre paréntesis.

     TO <xcFichNuevo> especifica el nuevo nombre de fichero, incluyendo
     la extensión y precedido opcionalmente por un indicador de vía y/o
     unidad. <xcFichNuevo> puede especificarse como cadena literal o
     expresión de caracteres encerrada entre paréntesis.

 Descripción

     RENAME es un mandato que cambia el nombre del fichero especificado por
     un nuevo nombre. Si el directorio fuente es diferente del directorio de
     destino, el fichero se mueve al nuevo directorio. RENAME no utiliza SET
     DEFAULT y SET PATH para buscar <xcFichAnterior>. <xcFichAnterior> sólo
     cambia de nombre si se encuentra en el directorio del DOS actual o en
     la vía especificada.

     Si <xcFichNuevo> ya existe o está abierto actualmente, RENAME no
     realiza ninguna acción. Para que esta condición se trate como un error,
     utilice la función FILE() antes de ejecutar el mandato. Consulte el
     ejemplo.

     ¡Advertencia! Antes de cambiar el nombre debe cerrarse el fichero.
     Si intenta cambiar el nombre de un fichero abierto, pueden producirse
     resultados imprevisibles. Cuando cambie de nombre un fichero de base de
     datos, recuerde que debe cambiar también el nombre de todos los
     ficheros memo (.dbt) asociados. En caso contrario, pone en peligro la
     integridad de su programa.

 Ejemplos

      Este ejemplo cambia el nombre de un fichero, comprobando si ya
        existe el fichero de destino antes de comenzar la operación:

        xcFichAnterior := "FichAnt.txt"
        xcFichNuevo    := "FichNuev.txt"
        IF !FILE(xcFichNuevo)
           RENAME (xcFichAnterior) TO (xcFichNuevo)
           ELSE
        ? "El fichero ya existe"
        ENDIF

 Ficheros   La biblioteca asociada es CLIPPER.LIB.

 To download this example - click here.

See Also: COPY FILE CURDIR() ERASE FILE() FERASE() FRENAME()