获取文件状态信息。

语法

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
);

参数

path
指向字符串的指针，该字符串包含现有文件或目录的路径。

buffer
指向存储结果的结构的指针。

返回值

如果获取到文件状态信息，则这些函数将返回 0。 返回值 -1 表示错误，在这种情况下，errno 设置为 ENOENT，表示找不到文件名或路径。 返回值为 EINVAL 表示参数无效；这种情况下 errno 还会设置为 EINVAL 。

有关返回代码的详细信息，请参阅 errno、_doserrno、_sys_errlist 和 _sys_nerr。

如果文件上的日期戳晚于 1970 年 1 月 1 日午夜，且早于 3000 年 12 月 31 日 23:59:59 (UTC)，就可以表示该日期戳，除非使用 _stat32 或 _wstat32，或已定义 _USE_32BIT_TIME_T，在这种情况下只能表示 2038 年 1 月 18 日 23:59:59 (UTC) 之前的日期。

备注

_stat 函数可获取有关 path 指定的文件或目录的信息，并将其存储在 buffer指向的结构中。 _stat 将根据情况自动处理多字节字符串参数，根据当前正在使用的多字节代码页识别多字节字符序列。

_wstat 是 _stat的宽字符版本； path 的 _wstat 参数是宽字符字符串。 _wstat 和 _stat 的行为方式相同，只不过 _wstat 不处理多字节字符字符串。

这些函数的变体支持 32 位或 64 位时间类型以及 32 位或 64 位文件长度。 第一个数字后缀（32 或 64）表示所用时间类型的大小；第二个后缀是 i32 或 i64，表示以 32 位还是 64 位整数表示文件大小。

_stat 等效于 _stat64i32，并且 struct _stat 包含 64 位时间，除非定义了 _USE_32BIT_TIME_T，在这种情况下旧行为有效；_stat 使用 32 位时间，并且 struct _stat 包含 32 位时间。 这一点也适用于 _stati64。

此函数验证其参数。 如果 path 或 buffer 是 NULL，则会调用无效参数处理程序，如参数验证中所述。

默认情况下，此函数的全局状态范围限定为应用程序。 若要更改此行为，请参阅 CRT 中的全局状态。

_stat 的时间类型和文件长度类型变体

一般文本例程映射

SYS\STAT.H 中定义的 _stat 结构包含下列字段。

如果 path 指的是一种设备，则 st_size、各种时间字段、 st_dev和 st_rdev 结构中的 _stat 字段没有意义。 由于 STAT.H 使用在 TYPES.H 中定义的 _dev_t 类型，因此你必须在代码中包含 TYPES.H，且将其置于 STAT.H 前面。

要求

有关兼容性的详细信息，请参阅 兼容性。

示例

// 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

另请参阅

文件处理
%>

_getmbcp
_setmbcp