FRENAME()
 Altera o nome de um arquivo
------------------------------------------------------------------------------

 Sintaxe

     FRENAME(<cArqCorr>, <cArqNovo>) --> NIL

 Argumentos

     <cArqCorr> é o nome do arquivo a ser renomeado, inclusive sua
     extensao.  Também podem ser incluidos como parte do nome uma letra
     indicativa do drive e/ou nome do path.

     <cArqNovo> é o novo nome do arquivo, incluindo extensao.  Também
     podem ser incluidos como parte do nome uma letra indicativa do drive
     e/ou nome do path.

 Retorno

     FRENAME() retorna -1 caso a operaçao falhe e zero se ela for bem
     sucedida.  Em caso de ter falhado, pode-se utilizar FERROR() para
     determinar a natureza do erro.

 Descriçao

     FRENAME() é uma funçao de tratamento de arquivos que altera o nome de
     um arquivo especificado, sendo idêntica ao comando RENAME.  Quando
     FRENAME() é chamada, o <cArqCorr> será renomeado somente se estiver
     localizado no diretório DOS corrente ou no path especificado. FRENAME()
     nao se utiliza de SET DEFAULT ou SET PATH para localizar o <cArqCorr>.
     Caso o diretório fonte seja diferente do diretório destino, o arquivo
     será removido para o diretório destino.  Se <cArqNovo> já existir ou
     estiver aberto no momento, FRENAME() falha e retorna -1, indicando que
     nao executou a açao solicitada.  A natureza do erro pode ser
     determinada através da funçao FERROR().

     -----------------------------------------------------------------------
     . Aviso

     Os arquivos devem ser fechados antes que se faça a alteraçao de seu
     nome.  A tentativa de renomear um arquivo aberto irá produzir
     resultados imprevisíveis.  Ao se renomear um arquivo de banco de dados,
     deve-se fazer o mesmo com o respectivo arquivo memo (.dbt).  Caso isso
     nao seja feito, a integridade do seu programa poderá ser comprometida.
     -----------------------------------------------------------------------

 Exemplos

     O exemplo a seguir demonstra como alterar o nome de um arquivo:

     IF FRENAME("OldFile.txt", "NewFile.txt") = -1
        ? "Erro na operaçao:", FERROR()
        BREAK
     ENDIF

 Arquivos:  Biblioteca CLIPPER.LIB.
 To download this example - click here.

See Also: FERASE() FERROR() FILE() CLOSE ERASE RENAME