FileLength64 (FileLength)

Jan 15, 2017 · 2 min read · dev manual powerBuilder fileOperations ·

Partilhar:

Overview

Explorando o universo do PowerBuilder, este artigo mergulha na utilização da função FileLength64, uma ferramenta essencial para desenvolvedores que buscam eficiência e precisão no manuseio de arquivos. Com uma abordagem didática, o texto desdobra a sintaxe, os possíveis retornos e os cenários de uso dessa funcionalidade, garantindo que você esteja bem equipado para lidar com arquivos de qualquer tamanho. Se você está à procura de otimizar seu fluxo de trabalho no PowerBuilder, vem com a gente nessa leitura!

Retorna o tamanho de um arquivo. Pode ser utilizado antes ou depois do FileOpen e recomenda-se o uso antes do FileRead.

Sintaxe:

FileLength64(filename)

Retorno:

longlong positivo com o tamanho do arquivo em bytes;
-1 se o arquivo não existir;
null se o argumento informado for null;

Destalhes sobre a função!

Appeon: A função FileLength64 não é suportada pelo Appeon, mas a FileLength é. Ambas são suportadas no PowerBuilder.
No PowerBuilder, o caminho relativo aponta para o diretório da aplicação, mas no Appeon o caminho relativo aponta para o diretório do Desktop do Usuário.

Esta função pode ser chamada antes ou depois do FileOpen. Assim você pode saber se o arquivo é maior que 32765bytes. Se for, utilize a função FileReadEx. Caso contrário, pode utilizar a função FileRead, mas pode ser que você encontre problemas com ela;
A função FileLength funciona da mesma forma que a FileLength64, mas só consegue ler arquivos que tenham até 2Gb. FileLength64 consegue ler arquivos de qualquer tamanho;
A função FileLength64 sempre retorna o tamanho do arquivo incluindo o byte-order mark (BOM);
Se o arquivo possuir algum controle de segurança/compartilhamento como, por exemplo, um arquivo na rede, você deve chamar a função FileLength64 antes da FileOpen ou depois da função FileClose. Caso contrário, você encontrar problemas de violação de acesso;

Como utilizar:

Exemplo 01:

string ls_arquivo
longlong lll_tamanho

ls_arquivo = "c:\temp\log.txt"

lll_tamanho = FileLength64(ls_arquivo)

Argumentos:

Argumento	Obrigatório	Descrição
filename	Sim	String com o arquivo que você deseja verificar tamanho.

Referência:

Dúvidas sobre o artigo? Sugestões? Precisa de ajuda com outra funcionalidade do PowerBuilder? Deixe um comentário.