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