_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.
Valor retornado
_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âmetro 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, confira Estado global no 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