Histórico da Página
Composition Setup |
---|
import.css=/download/attachments/6062824/tecnologia.css
|
Pagetitle | ||||
---|---|---|---|---|
|
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 | ||
---|---|---|
| ||
FCreate( < cArquivo >nRet := FCreate(<cArquivo>, [ nAtributo ], [ xParam3 ], [lChangeCase lChageCase ] ) |
Parâmetros
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 | Lógicobloco 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. |
...
Exemplos
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
#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 |