_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 関数