FERASE()
 Elimina arquivos do disco
------------------------------------------------------------------------------

 Sintaxe

     FERASE(<cArq>) --> nSuccess

 Argumentos

     <cArq> é o nome do arquivo a ser eliminado do disco.  O nome do
     arquivo deve ser especificado incluindo-se a extensao, e pode ou nao
     ser precedido de especificaçao de drive e/ou path.

 Retorno

     FERASE() retorna -1 se a operaçao falhar e zero se for bem sucedida.
     No caso de haver falha, FERROR() pode ser utilizada para determinar a
     natureza do erro.

 Descriçao

     FERASE() é uma funçao de tratamento de arquivos que elimina um arquivo
     especificado do disco.  FERASE() faz exatamente o mesmo que o comando
     ERASE, porém retorna um valor e pode ser especificada em uma
     expressao.  Quando FERASE() é chamada, o <cArq> somente é eliminado do
     disco se for encontrado no diretório DOS corrente ou no diretório
     explicitamente especificado como parte do nome do arquivo.  Da mesma
     forma que outras funçoes e comandos de tratamento de funçao, FERASE()
     nao utiliza SET DEFAULT nem SET PATH para localizar o <cArq>.

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

     Os arquivos devem ser fechados antes de serem removidos com a funçao
     FERASE().
     -----------------------------------------------------------------------

 Exemplos

       Este exemplo ilustra como eliminar um conjunto de arquivos
        que correspondam a um padrao de caracteres do tipo coringa:

        #include "Directry.ch"
        AEVAL(DIRECTORY("*.BAK"), { |aFile| FERASE(aFile[F_NAME]) })

       O exemplo a seguir apaga um arquivo e depois exibe uma
        mensagem caso a operaçao tenha falhado:

        IF FERASE("AFile.txt") = -1
           ? "Erro. Arquivo nao eliminado:", FERROR()
           BREAK
        ENDIF

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

See Also: FERROR() FRENAME() CLOSE ERASE RENAME