_stat, _stat32, , _stat64, _stati64, _stat32i64, _stat64i32, , _wstat, _wstat32, _wstat64_wstati64, _wstat32i64,_wstat64i32

Dosyayla ilgili durum bilgilerini alma.

Sözdizimi

int _stat(
   const char *path,
   struct _stat *buffer
);
int _stat32(
   const char *path,
   struct __stat32 *buffer
);
int _stat64(
   const char *path,
   struct __stat64 *buffer
);
int _stati64(
   const char *path,
   struct _stati64 *buffer
);
int _stat32i64(
   const char *path,
   struct _stat32i64 *buffer
);
int _stat64i32(
   const char *path,
   struct _stat64i32 *buffer
);
int _wstat(
   const wchar_t *path,
   struct _stat *buffer
);
int _wstat32(
   const wchar_t *path,
   struct __stat32 *buffer
);
int _wstat64(
   const wchar_t *path,
   struct __stat64 *buffer
);
int _wstati64(
   const wchar_t *path,
   struct _stati64 *buffer
);
int _wstat32i64(
   const wchar_t *path,
   struct _stat32i64 *buffer
);
int _wstat64i32(
   const wchar_t *path,
   struct _stat64i32 *buffer
);

Parametreler

path
Varolan dosya veya dizinin yolunu içeren bir dizenin işaretçisi.

buffer
Sonuçları depolayan yapı işaretçisi.

Dönüş değeri

Dosya durumu bilgileri alınırsa bu işlevlerin her biri 0 döndürür. -1 dönüş değeri, dosya adının veya yolun bulunamadığını belirten bir hata gösterir ve bu durumda errno olarak ayarlanır ENOENT. değerinin EINVAL dönüş değeri geçersiz bir parametreyi gösterir; errno bu durumda olarak da ayarlanır EINVAL .

İade kodları hakkında daha fazla bilgi için bkz. errno, _doserrno, _sys_errlistve _sys_nerr.

Veya kullanmadığınız _stat32 _wstat32veya tanımlamadığınız _USE_32BIT_TIME_Tsürece, bir dosyadaki tarih damgası gece yarısından, 1 Ocak 1970'ten sonra ve 23:59:59, 31 Aralık 3000, UTC'den önceyse temsil edilebilir. Bu durumda tarih yalnızca 23:59:59 Ocak 2038, UTC'ye kadar gösterilebilir.

Açıklamalar

işlevi tarafından _stat path belirtilen dosya veya dizin hakkında bilgi alır ve tarafından işaret edilen bufferyapıda depolar. _stat çok baytlı dize bağımsız değişkenlerini uygun şekilde otomatik olarak işler ve kullanımda olan çok baytlı kod sayfasına göre çok baytlı karakter dizilerini algılar.

_wstat , öğesinin _statgeniş karakterli bir sürümüdür; path bağımsız değişkeni _wstat geniş karakterli bir dizedir. _wstat ve _stat çok baytlı dizeleri işlememesi dışında _wstat aynı şekilde davranır.

Bu işlevlerin varyasyonları 32 bit veya 64 bit zaman türlerini ve 32 bit veya 64 bit dosya uzunluklarını destekler. İlk sayısal sonek (32 veya 64) kullanılan zaman türünün boyutunu gösterir; ikinci sonek ya da i32 i64olur ve dosya boyutunun 32 bit veya 64 bit tamsayı olarak temsil edilip edilmediğini belirtir.

_stat , ile _stat64i32eşdeğerdir ve struct _stat tanımlanmadığı sürece _USE_32BIT_TIME_T 64 bit bir süre içerir; bu durumda eski davranış etkindir; _stat 32 bit zaman kullanır ve struct _stat 32 bit zaman içerir. aynı durum için _stati64de geçerlidir.

Bu işlev parametrelerini doğrular. path veya buffer iseNULL, parametre doğrulamasında açıklandığı gibi geçersiz parametre işleyicisi çağrılır.

Varsayılan olarak, bu işlevin genel durumunun kapsamı uygulama olarak belirlenmiştir. Bu davranışı değiştirmek için bkz. CRT'de Genel durum.

Zaman türü ve dosya uzunluğu türü çeşitlemeleri _stat

Genel metin yordamı eşlemeleri

_stat içinde SYS\STAT.Htanımlanan yapısı aşağıdaki alanları içerir.

Bir cihaza başvuruyorsapath, yapısındaki st_size_stat çeşitli zaman alanları st_devve st_rdev alanları anlamsızdır. STAT.H içinde TYPES.Htanımlanan türü kullandığından_dev_t, kodunuzda daha önce STAT.H eklemeniz TYPES.H gerekir.

Gereksinimler

Daha fazla uyumluluk bilgisi için bkz . Uyumluluk.

Örnek

// crt_stat.c
// This program uses the _stat function to
// report information about the file named crt_stat.c.

#include <time.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <stdio.h>
#include <errno.h>

int main( void )
{
   struct _stat buf;
   int result;
   char timebuf[26];
   char* filename = "crt_stat.c";
   errno_t err;

   // Get data associated with "crt_stat.c":
   result = _stat( filename, &buf );

   // Check if statistics are valid:
   if( result != 0 )
   {
      perror( "Problem getting information" );
      switch (errno)
      {
         case ENOENT:
           printf("File %s not found.\n", filename);
           break;
         case EINVAL:
           printf("Invalid parameter to _stat.\n");
           break;
         default:
           /* Should never be reached. */
           printf("Unexpected error in _stat.\n");
      }
   }
   else
   {
      // Output some of the statistics:
      printf( "File size     : %ld\n", buf.st_size );
      printf( "Drive         : %c:\n", buf.st_dev + 'A' );
      err = ctime_s(timebuf, 26, &buf.st_mtime);
      if (err)
      {
         printf("Invalid arguments to ctime_s.");
         exit(1);
      }
      printf( "Time modified : %s", timebuf );
   }
}

File size     : 732
Drive         : C:
Time modified : Thu Feb 07 14:39:36 2002

Ayrıca bkz.

Dosya işleme
_access, _waccess
_fstat, _fstat32, _fstat64, , _fstati64, _fstat32i64, _fstat64i32
_getmbcp
_setmbcp