_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 に bufferNULL 場合はが設定されます。

解説

_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_atimest_ctimest_mtime と st_size のフィールドは意味がありません。

Stat.h が Types.h で定義されている _dev_t の型を使用するためコードに Stat.h の前に Types.h を含める必要があります。

_fstat64 は __stat64 構造を使用するを作成日 23:59 によって表されるを : 593000 12 年 1 月 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 の時刻型とファイル長の種類

必要条件

互換性の詳細については、「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 を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。

参照

関連項目

ファイル処理

_access、_waccess

_chmod、_wchmod

_filelength、_filelengthi64

_stat、_wstat 関数