Histórico da Página

Composition Setup
import.css=/download/attachments/327912/newLayout.css

...

Pagetitle

...

	MLCount

...

Colapse ALL

Expand ALL

Função: FCreate

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 ).Caso a operação não seja completa com sucesso, a função retorna o handler -1, caso contrário é retornado o handler de acesso ao arquivo, para operações de escrita.

Sintaxe

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

Parâmetros/Elementos

	MLCount

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 ).
Caso a operação não seja completa com sucesso, a função retorna o handler -1, caso contrário é retornado o handler de acesso ao arquivo, para operações de escrita.

Sintaxe

Bloco de código
nRet := FCreate(<cArquivo>, [nAtributo], [xParam3], [lChangeCase])

Parâmetros

...

Nome Tipo Descrição Obrigatório
...
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
...
nAtributo Numérico
...
Compatibilidade. Deve ser informado o valor nulo ( NIL ) ou 0 (zero), o arquivo sempre será criado com atributos default.
...
xParam3 Nulo Compatibilidade. Deve ser informado o valor nulo ( NIL )
...
lChageCase
...
Lógico
Determina se o nome do arquivo será convertido para letras maiúsculas ou se não será feito nenhum ajuste.
.T. - Transforma o nome do arquivo
...
para letras
...
maiúsculas (Default)
.F.
...
- Não realiza nenhum ajuste no nome do arquivo informado
...

...

Retorno

Nome

...

Tipo

...

Descrição
nRet

...

Numérico

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

...

.

Exemplo

Observações

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().

Exemplos

Bloco de código

theme	Eclipse
language	cpp
linenumbers	true

#include "Fileio.ch"

// criar arquivo texto vazio a partir do root path no servidor



user function exemplo()

    local nHandle := FCREATE("\Testfile.txt")

If



    if nHandle = -1

conout("Erro ao criar arquivo - ferror " + Str(Ferror()))

Else

//

escreve

else

a

hora atual

do

servidor

em

string

no

arquivo

FWrite(nHandle, Time() + CRLF)

FClose(nHandle)

EndIf

Abrangência

Advanced Protheus 6.09 , Advanced Protheus 7.10 , Microsiga Protheus 8.11 , Protheus 10 , TOTVS Application Server 10 , ByYou Application Server

Veja Também

FClose


    endif

return

Árvore de páginas

Versões comparadas

Versão antiga 3

Nova versão 4

Chave

Função: FCreate

Sintaxe

Parâmetros

Retorno

Exemplo