Descrição
| Cria um arquivo vazio no disco, para operação de escrita em modo exclusivo, com o tamanho de 0 ( zero ) bytes.Se o arquivo especificado já existe no disco, o arquivo é aberto em modo exclusivo, e seu conteúdo é eliminado ( truncado em 0 bytes ).. |
Sintaxe
| FCreate( <cArquivo>, <nAtributo>, <uParam3>, <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 | nAtributo |
Numérico |
Compatibilidade. Deve ser informado o valor nulo ( NIL ) ou 0 (zero), o arquivo sempre será criado com atributos default |
|||
| 03 | uParam3 |
Indefinido |
Compatibilidade. Deve ser informado o valor nulo ( NIL ) |
|||
| 04 | 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 |
| xRet | Indefinido |
Retorna |
Exemplo
#INCLUDE "TOTVS.CH" User Function FCreate() Local nHandle := 0 nHandle := FCREATE( "\TEST.TXT" ) If !FCLOSE(nHandle) Conout( "Erro ao fechar arquivo, erro numero: ", FERROR() ) Endif Return( Nil )
Resultado
Informações adicionais
|
nRet Caso não seja possível criar o arquivo, a função retornará o handle -1. Para obter mais detalhes da casua da ocorrência, utilize a função FError() |
|
lChangeCase .T. – Transforma o nome do arquivo para letras maiúsculas (Default) .F. – Não realiza nenhum ajuste no nome do arquivo informado. |
Gostou? Compartilhe com seus amigos e deixe um comentário! 😎