FCreate

FCreate ( < cArquivo>, [ nAtributo], [ xParam3], [ lChangeCase] ) --> nRet

(numerico)
• Retorna o handle do arquivo para ser usado nas demais funções de manutenção de arquivo. O handle será maior ou igual a zero. 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().

FCreate() é uma função de baixo nível que permite a manipulação direta dos arquivos textos como binários. Ao ser executada, cria um arquivo ou elimina o seu conteúdo e retorna o handle (manipulador) do arquivo para ser usado nas demais funções de manutenção de arquivo. Após ser utilizado, o arquivo deve ser fechado através da função FClose().

Quando é informado um path relativo (ex: "\temp\arquivo.txt") o arquivo será salvo no servidor; para que o mesmo seja salvo na máquina cliente (smartclient) é necessário informar um path absoluto (ex: "C:\home\user\arquivo.txt"). Em clientes UNIX, a letra de drive informada será ignorada, os caracteres '\' serão automaticamente convertidos em '/' e o arquivo citado no exemplo anterior seria então gravado em "/home/user/arquivo.txt".

Caso o arquivo já exista, o conteúdo do mesmo será eliminado e seu tamanho truncado para 0 (zero) bytes. Caso seja necessário alguma alteração no atributo do arquivo, utilizar a função chmod().

#include "Fileio.ch"
// criar arquivo texto vazio a partir do root path no servidor
nHandle := FCREATE("\Testfile.txt")
If nHandle = -1   
conout("Erro ao criar arquivo - ferror " + Str(Ferror()))
Else   // escreve a hora atual do servidor em string no arquivo   
FWrite(nHandle, Time() + CRLF)   
FClose(nHandle)
EndIf