Histórico da Página

...

Bloco de código

collapse	false

FOpen( < cArq >, [ nModo ], [ xParam3 ], [ lChageCaselChangeCase ] )

Parâmetros

Nome	Tipo	Descrição	Obrigatório
cArq	caractere	Indica o nome do arquivo que será aberto que inclui o path, caso haja um.	X
nModo	numérico	Indica o modo de acesso DOS solicitado que indicará como o arquivo aberto deve ser acessado. O acesso é uma das categorias relacionadas na tabela A e as retrições de compartilhamento estão na tabela B. O modo padrão é 0 (zero), aberto para leitura, com compartilhamento por compatibilidade. Ao definirmos o modo de acesso, deve-se somar um elemento da tabela A com a B.
xParam3	qualquer	Compatibilidade. Deve ser informado o valor nulo ( NIL )
lChageCaselChangeCase	lógico	Indica se, Se verdadeiro (.T.), a busca do nome do arquivo deve ser em letra minúsculanomes de arquivos e pastas serão convertidos para letras minúsculas; caso contrário, falso (.F.), a busca será realizada conforme foi escrito. Conteúdo padrão = .Tnão será feito nenhum ajuste no nome do arquivo informado. Valor padrão (.T.). Veja maiores informações em Observações.

Nome	Tipo	Descrição
nRet	numérico	Retorna o handle de arquivo aberto, na faixa de 0 a 65.535. Caso ocorra um erro, o retorno será -1.

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 comportamento de Case Sensitive definido pelas chaves de ini CASESENSITIVE ou SERVERTYPE. Porem, quando não especificado o parâmetro, o valor padrão (.T.) fica condicionado ao que está configurado nessas chaves.
Toda vez que houver um erro na abertura do arquivo, a função FError() pode ser utilizada para retornar o código de erro do sistema operacional. Por exemplo, caso o arquivo não exista, a função FOpen() retornará -1 e FError() retornará 2 para indicar que o arquivo não foi encontrado.
Caso o arquivo especificado seja aberto, o valor retornado é o handle (manipulador) do sistema operacional para o arquivo. Este valor é semelhante a um alias no sistema de banco de dados e é exigido para identificar o arquivo aberto para as outras funções de tratamento de arquivo. Portanto, é importante sempre atribuir o valor que foi retornado a uma variável para uso posterior.

...