_fstat、_fstat32、_fstat64、_fstati64、_fstat32i64、_fstat64i32
開いているファイルに関する情報を取得します。
int _fstat(
int fd,
struct _stat *buffer
);
int _fstat32(
int fd,
struct __stat32 *buffer
);
int _fstat64(
int fd,
struct __stat64 *buffer
);
int _fstati64(
int fd,
struct _stati64 *buffer
);
int _fstat32i64(
int fd,
struct _stat32i64 *buffer
);
int _fstat64i32(
int fd,
struct _stat64i32 *buffer
);
パラメーター
fd
開いているファイルのファイル記述子を返します。buffer
結果を格納する構造体へのポインター。
戻り値
ファイルのステータス情報を取得すると 0 を返します。 –1 の戻り値はエラーを示します。 ファイル記述子が無効であるか、buffer が NULLの場合、無効なパラメーター ハンドラーが パラメーターの検証"に説明されているように、呼び出されます。 実行の継続 errno は EBADFに無効なファイル記述子の場合、または EINVALに buffer が NULLに設定されます。
解説
_fstat 関数は fd とストアに関連付けられているファイルに関する情報を bufferが指す構造体に格納します。 SYS\Stat.h で定義されている _stat 構造体には、次のフィールドがあります。
st_atime
最後のファイル アクセス時間。st_ctime
ファイルが作成された時刻。st_dev
デバイス、fd; それ以外の場合は 0。st_mode
ファイル モード情報を示すビット マスク。 _S_IFCHR ビットは fd がデバイスを参照設定されます。 _S_IFREG ビットは fd を通常のファイルを参照していることが設定されます。 読み取り/書き込みビットはファイルのアクセス許可モードに基づいて設定されます。 _S_IFCHR などの定数は SYS\Stat.h で定義されます。st_mtime
ファイルが最後に変更された場合。st_nlink
NTFS 以外のファイル システムの場合は常に 1。st_rdev
デバイス、fd; それ以外の場合は 0。st_size
ファイルのバイト単位のサイズ。
fd がデバイスを参照する場合は、st_atime、st_ctime、st_mtimeと st_size フィールドは意味がありません。
Stat.h が Types.h で定義されている _dev_t の型を使用するため、コードに Stat.h の前に Types.h を含める必要があります。
_fstat64は __stat64 構造体を使用する作成日を 23:59 によって表される (: 59、3000 12 年 10 月 31 日は、UTC; 他の関数が 03:14 だけで日付を表す場合: 1 年 1 月 07 日 19 時 2038、UTC。 午前 1970 は 1 年 1 月 1 日、これらすべての関数の日付範囲の下限です。
これらの関数のバリエーションが 32 ビットまたは 64 ビットの時刻型、および 32 ビットまたは 64 ビットのファイル長をサポートします。 最初の数字サフィックス (32 または 64) は使用されている時刻型のサイズを表し、2 番目のサフィックス (i32 または i64) はファイル サイズが 32 ビットまたは 64 ビットのどちらの整数値で表されているかを示します。
_fstat は _fstat64i32と等価であり、struct_stat は 64 ビットの時刻が格納されます。 これは、古い動作が有効な場合 _USE_32BIT_TIME_T が定義されていない場合に、; _fstat は 32 ビットの時刻を使用し、struct_stat は 32 ビットの時刻が格納されます。 これは、_fstati64 にも当てはまります。
_stat の時刻型とファイル長の種類
関数 |
_USE_32BIT_TIME_T の定義 |
時刻型 |
ファイル長の種類 |
---|---|---|---|
_fstat |
定義なし |
64 ビット |
32 ビット |
_fstat |
定義済み |
32 ビット |
32 ビット |
_fstat32 |
マクロ定義の影響は受けません |
32 ビット |
32 ビット |
_fstat64 |
マクロ定義の影響は受けません |
64 ビット |
64 ビット |
_fstati64 |
定義なし |
64 ビット |
64 ビット |
_fstati64 |
定義済み |
32 ビット |
64 ビット |
_fstat32i64 |
マクロ定義の影響は受けません |
32 ビット |
64 ビット |
_fstat64i32 |
マクロ定義の影響は受けません |
64 ビット |
32 ビット |
必要条件
関数 |
必須ヘッダー |
---|---|
_fstat |
<sys/stat.h と> sys </types.h> |
_fstat32 |
<sys/stat.h と> sys </types.h> |
_fstat64 |
<sys/stat.h と> sys </types.h> |
_fstati64 |
<sys/stat.h と> sys </types.h> |
_fstat32i64 |
<sys/stat.h と> sys </types.h> |
_fstat64i32 |
<sys/stat.h と> sys </types.h> |
互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。
使用例
// crt_fstat.c
// This program uses _fstat to report
// the size of a file named F_STAT.OUT.
#include <io.h>
#include <fcntl.h>
#include <time.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <errno.h>
#include <share.h>
int main( void )
{
struct _stat buf;
int fd, result;
char buffer[] = "A line to output";
char timebuf[26];
errno_t err;
_sopen_s( &fd,
"f_stat.out",
_O_CREAT | _O_WRONLY | _O_TRUNC,
_SH_DENYNO,
_S_IREAD | _S_IWRITE );
if( fd != -1 )
_write( fd, buffer, strlen( buffer ) );
// Get data associated with "fd":
result = _fstat( fd, &buf );
// Check if statistics are valid:
if( result != 0 )
{
if (errno == EBADF)
printf( "Bad file descriptor.\n" );
else if (errno == EINVAL)
printf( "Invalid argument to _fstat.\n" );
}
else
{
printf( "File size : %ld\n", buf.st_size );
err = ctime_s(timebuf, 26, &buf.st_mtime);
if (err)
{
printf("Invalid argument to ctime_s.");
exit(1);
}
printf( "Time modified : %s", timebuf );
}
_close( fd );
}
同等の .NET Framework 関数
使用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。