_filelength, _filelengthi64_filelength, _filelengthi64

Obtiene la longitud de un archivo.Gets the length of a file.

SintaxisSyntax

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

ParámetrosParameters

FDfd
Se destina al descriptor de archivo.Target the file descriptor.

Valor devueltoReturn Value

Tanto _filelength como _filelengthi64 devuelven la longitud del archivo, en bytes, del archivo de destino asociado a FD.Both _filelength and _filelengthi64 return the file length, in bytes, of the target file associated with fd. Si FD es un descriptor de archivo no válido, esta función invoca el controlador de parámetros no válidos, tal y como se describe en validación de parámetros.If fd is an invalid file descriptor, this function invokes the invalid parameter handler, as described in Parameter Validation. Si la ejecución puede continuar, ambas funciones devuelven-1L para indicar un error y establecer errno en EBADF.If execution is allowed to continue, both functions return -1L to indicate an error and set errno to EBADF.

ObservacionesRemarks

De forma predeterminada, el ámbito de este estado global de esta función es la aplicación.By default, this function's global state is scoped to the application. Para cambiar esto, vea estado global en CRT.To change this, see Global state in the CRT.

RequisitosRequirements

FunciónFunction Encabezado necesarioRequired header
_filelength_filelength <io.h>
_filelengthi64_filelengthi64 <io.h>

Para obtener más información sobre compatibilidad, vea Compatibility.For more compatibility information, see Compatibility.

EjemploExample

Consulte el ejemplo de _chsize.See the example for _chsize.

Consulta tambiénSee also

Control de archivosFile Handling
_chsize_chsize
_fileno_fileno
_fstat, _fstat32, _fstat64, _fstati64, _fstat32i64, _fstat64i32_fstat, _fstat32, _fstat64, _fstati64, _fstat32i64, _fstat64i32
_stat, _wstat (Funciones)_stat, _wstat Functions