Histórico da Página

...

Bloco de código

collapse	false

FCreate( < cArquivo >, [ nAtributo ], [ xParam3 ], [ lChageCaselChangeCase ] )

Parâmetros

Nome	Tipo	Descrição	Obrigatório
cArquivo	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	Compatibilidade. Deve ser informado o valor nulo ( NIL ) ou 0 (zero), o arquivo sempre será criado com atributos default.
xParam3	nil	Compatibilidade. Deve ser informado o valor nulo ( NIL )
lChageCaselChangeCase	lógicoDetermina	se o nome do arquivo será convertido para letras maiúsculas ou se não será feito nenhum ajuste. Se .T. - Transforma o nome do arquivo para letras maiúsculas (Default) .F. - Não realiza nenhum ajuste no nome do arquivo informado, nome de arquivos e pastas serão convertidos para letras minúsculas, e se for .F. não altera o nome informado. Caso não especificado, o valor padrão é .T., exceto se houver a configuração das chaves de ini CASESENSITIVE ou SERVERTYPE.

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.

Observações

O parâmetro opcional lChangeCase foi introduzido a partir do build 7.00.131227A pois em sistemas LINUX/UNIX, existe a diferenciação entre maiúsculo e minúsculo em nomes de arquivos ou pastas. Quando este parâmetro for informado, terá prioridade sobre o comportamento de CASE SENSITIVE definido pelas chaves de ini CASESENSITIVE ou SERVERTYPE.

Exemplos

Bloco de código

language	cpp
theme	Eclipse
linenumbers	true
collapse	false

#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

...

Árvore de páginas

Versões comparadas

Versão antiga 7

Nova versão 8

Chave

Parâmetros

Retorno

Observações

Exemplos