_stat, _stat32, _stat64, _stati64, _stat32i64, _stat64i32, _wstat, _wstat32, _wstat64, _wstati64, _wstat32i64, _wstat64i32

Obtenga información de estado sobre un archivo.

Sintaxis

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

Parámetros

path
Puntero a una cadena que contiene la ruta de acceso del directorio o el archivo existente.

buffer
Puntero a la estructura que almacena los resultados.

Valor devuelto

Cada una de estas funciones devuelve 0 si se obtiene la información de estado de archivo. Un valor devuelto de -1 indica un error, en cuyo caso errno se establece ENOENTen , lo que indica que no se encontró el nombre de archivo o la ruta de acceso. Un valor devuelto de EINVAL indica un parámetro no válido; errno también se establece en EINVAL en este caso.

Para obtener más información sobre los códigos de retorno, vea errno, _doserrno, _sys_errlist y _sys_nerr.

La marca de fecha de un archivo se puede representar si es posterior a medianoche, 1 de enero de 1970 y antes de las 23:59:59, 31 de diciembre de 3000, UTC, a menos que use _stat32 o _wstat32, o haya definido _USE_32BIT_TIME_T, en cuyo caso la fecha solo se puede representar hasta las 23:59:59 del 18 de enero de 2038, UTC.

Comentarios

La función _stat obtiene información sobre el archivo o el directorio especificado por path y lo almacena en la estructura que señala buffer. _stat controla automáticamente argumentos de cadenas de caracteres multibyte según corresponda, reconociendo secuencias de caracteres multibyte según la página de códigos multibyte actualmente en uso.

_wstat es una versión con caracteres anchos de _stat; el argumento path para _wstat es una cadena de caracteres anchos. _wstat y _stat se comportan de manera idéntica, salvo que _wstat no controla las cadenas de caracteres multibyte.

Las variaciones de estas funciones admiten tipos de tiempo de 32 o 64 bits y longitudes de archivo de 32 o 64 bits. El primer sufijo numérico (32 o 64) indica el tamaño del tipo de tiempo usado; el segundo sufijo es i32 o i64, lo que indica si el tamaño del archivo se representa como un entero de 32 o 64 bits.

_stat es equivalente a _stat64i32y struct _stat contiene un tiempo de 64 bits, a menos _USE_32BIT_TIME_T que se defina, en cuyo caso el comportamiento anterior está en vigor; _stat usa un tiempo de 32 bits y struct _stat contiene un tiempo de 32 bits. Lo mismo ocurre para _stati64.

Nota:

_wstat no funciona con vínculos simbólicos de Windows Vista. En estos casos, _wstat siempre notificará un tamaño de archivo de 0. _stat funciona correctamente con vínculos simbólicos. La _statfamilia de funciones usa CreateFile en Visual Studio 2015, en lugar de FindFirstFile como en Visual Studio 2013 y versiones anteriores. Esto significa que, en una ruta de acceso que _stat termina con una barra diagonal, se realiza correctamente si la ruta de acceso hace referencia a un directorio, en lugar de a antes de cuando la función produciría un error con establecido ENOENTen errno .

Esta función valida sus parámetros. Si o pathbuffer es NULL, se invoca el controlador de parámetros no válidos, como se describe en Validación de parámetros.

De manera predeterminada, el estado global de esta función está limitado a la aplicación. Para cambiar este comportamiento, consulte Estado global en CRT.

Variaciones de tipo de tiempo y tipo de longitud de archivo _stat

Functions	_USE_32BIT_TIME_T definido	Tipo de tiempo	Tipo de longitud de archivo
_stat, _wstat	No definida	64 bits	32 bits
_stat, _wstat	Definido	32 bits	32 bits
_stat32, _wstat32	No se ve afectada por la definición de macro	32 bits	32 bits
_stat64, _wstat64	No se ve afectada por la definición de macro	64 bits	64 bits
_stati64, _wstati64	No definida	64 bits	64 bits
_stati64, _wstati64	Definido	32 bits	64 bits
_stat32i64, _wstat32i64	No se ve afectada por la definición de macro	32 bits	64 bits
_stat64i32, _wstat64i32	No se ve afectada por la definición de macro	64 bits	32 bits

Asignaciones de rutinas de texto genérico

Rutina TCHAR.H	_UNICODE y _MBCS no definidos	_MBCS definido	_UNICODE definido
_tstat	_stat	_stat	_wstat
_tstat64	_stat64	_stat64	_wstat64
_tstati64	_stati64	_stati64	_wstati64
_tstat32i64	_stat32i64	_stat32i64	_wstat32i64
_tstat64i32	_stat64i32	_stat64i32	_wstat64i32

La estructura _stat, que se define en SYS\STAT.H, incluye los campos siguientes.

Campo	Descripción
st_gid	Identificador numérico del grupo que posee el archivo (específico de UNIX). Este campo siempre será cero en sistemas Windows. Un archivo redirigido se clasifica como archivo Windows.
st_atime	Hora del último acceso del archivo. Válido en NTFS, pero no en unidades de disco con formato FAT.
st_ctime	Hora de creación del archivo. Válido en NTFS, pero no en unidades de disco con formato FAT.
st_dev	Número de unidad del disco que contiene el archivo (igual que st_rdev).
st_ino	Número del nodo de información ( inode) para el archivo (específico de UNIX). En sistemas de archivos UNIX, inode describe la fecha del archivo y las marcas de tiempo, los permisos y el contenido. Cuando los archivos se vinculan físicamente entre sí, comparten el mismo inode. inodey, por tanto, st_ino, no tiene ningún significado en los sistemas de archivos FAT, HPFS o NTFS.
st_mode	Máscara de bits para información de modo de archivo. El bit _S_IFDIR se establece si path especifica un directorio; el bit _S_IFREG se establece si path especifica un archivo normal o un dispositivo. Los bits de lectura y escritura de usuario se establecen según el modo de permiso del archivo; los bits de ejecución de usuario se establecen según la extensión del nombre de archivo.
st_mtime	Hora de la última modificación del archivo.
st_nlink	Siempre 1 en sistemas de archivos que no son NTFS.
st_rdev	Número de unidad del disco que contiene el archivo (igual que st_dev).
st_size	Tamaño del archivo en bytes; entero de 64 bits para variaciones con el sufijo i64.
st_uid	Identificador numérico del usuario propietario del archivo (específico de UNIX). Este campo siempre será cero en los sistemas Windows. Un archivo redirigido se clasifica como archivo Windows.

Si path hace referencia a un dispositivo, st_size, varios campos de tiempo, st_devy los campos st_rdev de la estructura _stat no tienen sentido. Dado que STAT.H usa el tipo _dev_t, que se define en TYPES.H, debe incluir TYPES.H delante de STAT.H en el código.

Requisitos

Routine	Encabezado necesario	Encabezados opcionales
_stat, _stat32, _stat64, _stati64, _stat32i64, _stat64i32	<sys/types.h> seguido de <sys/stat.h>	<errno.h>
_wstat, _wstat32, _wstat64, _wstati64, _wstat32i64, _wstat64i32	<sys/types.h> seguido de <sys/stat.h> o <wchar.h>	<errno.h>

Para obtener más información sobre compatibilidad, consulte Compatibilidad.

Ejemplo

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

Consulte también

Control de archivos
_access, _waccess
_fstat, _fstat32, _fstat64, _fstati64, _fstat32i64, _fstat64i32
_getmbcp
_setmbcp