_filelength, _filelengthi64

Obtém o tamanho de um arquivo.

Sintaxe

long _filelength(
   int fd
);
__int64 _filelengthi64(
   int fd
);

Parâmetros

fd
Direciona o descritor do arquivo.

Retornar valor

_filelength e _filelengthi64 retornam o tamanho do arquivo, em bytes, do arquivo de destino associado a fd. Se fd for um descritor de arquivo inválido, essa função invocará o manipulador de parâmetros inválido, conforme descrito em Validação de parâmetro. Se a execução tiver permissão para continuar, ambas as funções retornarão -1L para indicar um erro e definirão errno como EBADF.

Comentários

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, consulte Estado global na CRT.

Requisitos

Função	Cabeçalho necessário
_filelength	<io.h>
_filelengthi64	<io.h>

Para obter informações sobre compatibilidade, consulte Compatibilidade.

Exemplo

Confira o exemplo de _chsize.

Confira também

Manipulação de arquivos
_chsize
_fileno
_fstat, _fstat32, _fstat64, _fstati64, _fstat32i64, _fstat64i32
_stat, _wstat funções