_stat, _stat32, , _stati64_stat32i64, _stat64i32, _wstat_wstat64_wstat32, , _wstat32i64_wstati64_stat64_wstat64i32

Ottenere informazioni sullo stato di un file.

Sintassi

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

Parametri

path
Puntatore a una stringa contenente il percorso del file o directory esistente.

buffer
Puntatore alla struttura che archivia i risultati.

Valore restituito

Ognuna di queste funzioni restituisce 0 se si ottengono le informazioni sullo stato dei file. Il valore restituito -1 indica un errore, nel qual caso errno è impostato su ENOENT, a indicare che non è stato possibile trovare il nome file o il percorso. Un valore restituito pari a EINVAL indica un parametro non valido; anche errno è impostato su EINVAL in questo caso.

Per altre informazioni sui codici restituiti, vedere errno, _doserrno, _sys_errliste _sys_nerr.

Il timbro di data in un file può essere rappresentato se è successivo a mezzanotte, 1 gennaio 1970 e prima delle 23:59:59, 31 dicembre 3000, UTC, a meno che non si usi _stat32 o _wstat32, o che sia definita _USE_32BIT_TIME_T, nel qual caso la data può essere rappresentata solo fino alle 23.59.59.59 del 18 gennaio 2038, UTC.

Osservazioni:

La funzione _stat ottiene informazioni sul file o sulla directory specificati da path e le archivia nella struttura a cui punta buffer. _stat gestisce automaticamente gli argomenti stringa di caratteri multibyte in base alle esigenze, riconoscendo le sequenze di caratteri multibyte in base alla tabella codici multibyte attualmente in uso.

_wstat è una versione a caratteri wide di _stat; l'argomento path in _wstat è una stringa di caratteri wide. _wstat e _stat si comportano in modo identico, ad eccezione del fatto che _wstat non gestisce stringhe di caratteri multibyte.

Le varianti di queste funzioni supportano tipi di tempo a 32 bit o a 64 bit e lunghezze di file a 32 bit o a 64 bit. Il primo suffisso numerico (32 o 64) indica le dimensioni del tipo time usato; il secondo suffisso è i32 o i64, che indica se le dimensioni del file sono rappresentate come intero a 32 bit o 64 bit.

_statequivale a e struct _stat contiene un tempo a _stat64i3264 bit, a meno che non _USE_32BIT_TIME_T sia definito, nel qual caso il comportamento precedente è attivo; _stat usa un'ora a 32 bit e struct _stat contiene un tempo a 32 bit. Lo stesso vale per _stati64.

Questa funzione convalida i relativi parametri. path Se o buffer è NULL, viene richiamato il gestore di parametri non validi, come descritto in Convalida dei parametri.

Per impostazione predefinita, lo stato globale di questa funzione è limitato all'applicazione. Per modificare questo comportamento, vedere Stato globale in CRT.

Variazioni del tipo di tempo e del tipo di lunghezza del file _stat

Mapping di routine di testo generico

La _stat struttura, definita in SYS\STAT.H, include i campi seguenti.

Se path fa riferimento a un dispositivo, i campi st_size, i vari campi ora, st_deve st_rdev nella struttura _stat non hanno alcun significato. Poiché STAT.H usa il _dev_t tipo definito in TYPES.H, è necessario includere TYPES.H prima STAT.H nel codice.

Requisiti

Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

Esempio

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

Vedi anche

Gestione dei file
_access, _waccess
_fstat, _fstat32, _fstat64, _fstati64, _fstat32i64_fstat64i32
_getmbcp
_setmbcp