TOTVSTEC

Árvore de páginas

Versões comparadas

Versão antiga 5

changes.mady.by.user Danilo Coimbra Sigolo

Gravado em

comparado com

Nova versão 6

changes.mady.by.user Daniel Otto Bolognani

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Composition Setup
import.css=/download/attachments/6062824/tecnologia.css

Pagetitle
FCreate
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

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

Parâmetros

Lógico

Nome

Tipo

Descrição

Obrigatório

Referência

cArquivo

Caracter

caractere

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

numérico

Compatibilidade. Deve ser informado o valor nulo ( NIL ) ou 0 (zero), o arquivo sempre será criado com atributos default.

 

 

xParam3

Nulo

qualquer

Compatibilidade. Deve ser informado o valor nulo ( NIL )

 

 

lChageCase

bloco de código

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

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.

...

Exemplos

Bloco de código
languagecpp
themeEclipse
languagelinenumberscpptrue
linenumberscollapsetruefalse
#include "Fileio.ch"

user function exemplo()

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

    if nHandle = -1   
        conout("Erro ao criar arquivo - ferror " + Str(Ferror()))
    else
        FWrite(nHandle, Time() + CRLF)   
        FClose(nHandle)
    endif

return

Veja também