Descrição
FERASE [AS] - 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! 😎
