TOTVSTEC

Árvore de páginas

Você está vendo a versão antiga da página. Ver a versão atual.

Comparar com o atual Ver Histórico da Página

« Anterior Versão 4 Próxima »

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

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

Parâmetros

NomeTipoDescriçãoObrigatório
cArquivoCaracterIndica 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
nAtributoNuméricoCompatibilidade. Deve ser informado o valor nulo ( NIL ) ou 0 (zero), o arquivo sempre será criado com atributos default. 
xParam3NuloCompatibilidade. Deve ser informado o valor nulo ( NIL ) 
lChageCaseLó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

NomeTipoDescrição
nRetNumé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

#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
  • Sem rótulos