Descrição
| Exclui um arquivo do disco. |
Sintaxe
| FERASE( <cArquivo>, <uParam2>, <lChangeCase> ) |
Parâmetros
| Par | Nome | Tipo | Descrição | Default | Obg | Ref |
| 01 |
cArquivo |
Caracter |
Indica o nome do arquivo que será criado. Pode-se especificar um path absoluto ou relativo para criar arquivos no ambiente local (SmartClient) ou no servidor |
X | ||
| 02 | uParam2 | Indefinido | Compatibilidade. Deve ser informado o valor nulo ( NIL ) | |||
| 03 | lChangeCase | Boolean | Determina se o nome do arquivo será convertido para letras maiúsculas ou se não será feito nenhum ajuste. |
Retorno
| Retorno | Tipo | Descrição |
| nRet | Numérico |
Retorna 0 (zero), se o arquivo for apagado com sucesso, e -1, caso não seja possível. Se o retorno for -1, é possível utilizar a função FError() para obter mais detalhes da ocorrência |
Exemplo
#INCLUDE "TOTVS.CH"
User Function FERASE()
Local nHandle := 0
nHandle := FCREATE( "\TEST.TXT" )
If !FCLOSE(nHandle)
Conout( "Erro ao fechar arquivo, erro numero: ", FERROR() )
Endif
If FERASE("\TEST.TXT") == -1
MsgStop('Falha na deleção do Arquivo','UniversoADVPL')
Endif
Return( Nil )
Resultado
Informações adicionais
|
Essa função faz exatamente a mesma coisa que o comando Erase, porém, retorna um valor e pode ser especificada em uma expressão |
|
Quando a função é chamada, o arquivo indicado, no parâmetro <cArquivo>, somente é eliminado do disco se for encontrado no diretório DOS – Disk Operating System (sistema operacional de disco) corrente ou no diretório especificado como parte do nome do arquivo. |
|
Essa função não utiliza os comandos Set Default e Set Path para localizar o arquivo indicado no parâmetro |
|
Caracteres do tipo curinga (Wildcards) (* ou ?) não são permitidos na especificação de arquivos |
|
Os arquivos devem ser fechados antes de serem excluídos pela função FErase() |
Gostou? Compartilhe com seus amigos e deixe um comentário! 😎