_filelength, _filelengthi64

ファイルの長さを取得します。

構文

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

パラメーター

fd
ファイル記述子をターゲットにします。

戻り値

_filelength と _filelengthi64 のいずれも、fd に関連付けられているターゲット ファイルのファイルの長さ (バイト単位) を返します。 無効なファイル記述子の場合fd、「パラメーターの検証」で説明されているように、この関数は無効なパラメーター ハンドラーを呼び出します。 実行を続行できる場合、両方の関数は -1L を返してエラーを示し、次に設定 errno します EBADF。

解説

既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT のグローバル状態」を参照してください。

必要条件

機能	必須ヘッダー
_filelength	<io.h>
_filelengthi64	<io.h>

互換性の詳細については、「 Compatibility」を参照してください。

例

_chsize の例を参照してください。

関連項目

ファイル処理
_chsize
_fileno
_fstat, _fstat32, _fstat64, _fstati64, _fstat32i64, _fstat64i32
_stat、_wstat 関数