_stat, _wstat funções

Obter informações sobre o status de um arquivo.

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(str
   const char *path,
      struct _stat32i64 *buffer 
);
int _stat64i32(str
      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
  Ponteiro para uma seqüência de caracteres que contém o caminho do arquivo ou diretório existente.

• buffer
  Ponteiro para a estrutura que armazena os resultados.

Valor de retorno

Cada uma dessas funções retornará 0 se as informações de status do arquivo são obtidas.Um valor retornado de – 1 indica um erro, na qual caso errno é conjunto para ENOENT, indicando que o caminho ou nome de arquivo não pôde ser encontrado. Um valor retornado de EINVAL indica um parâmetro inválido; errno também é conjunto para EINVAL Nesse caso.

Observação:
Se path contém o local de um diretório, ele não pode conter uma barra invertida. Se isso acontecer, -1 será retornado e errno será conjunto para ENOENT.

See _doserrno, errno, _sys_errlist e _sys_nerr para obter mais informações sobre esse e outros, retorne códigos.

O carimbo de data em um arquivo pode ser representado, se ele for mais recente do que meia-noite, 1 º de janeiro de 1970 e antes de 23: 59: 59, 31 de dezembro de 3000, UTC, a menos que você use _stat32 ou _wstat32, ou tiver definido _USE_32BIT_TIME_T, caso em que a data pode ser representada somente até 14: 03: 07 19 de janeiro de 2038, UTC.

Comentários

The _stat função obtém informações sobre o arquivo ou diretório especificado por path e os armazenamentos na estrutura de apontada por buffer. _stattrata automaticamente sistema autônomo argumentos de seqüência de caractere multibyte conforme apropriado, reconhecendo seqüências de caractere de multibyte de acordo com para a página de código multibyte atualmente em uso.

_wstat é uma versão de caractere largo da _stat; o path argumento para _wstat é uma seqüência de caracteres largos. _wstat e _stat tenham comportamento idêntico, exceto que _wstat não trata as seqüências de caractere de multibyte.

Variações dessas funções oferece suporte a tipos de 32 ou 64 bit de time e tamanhos de arquivo de 32 ou 64 bit.O primeiro sufixo numérico (32 ou 64) indica o dimensionar do time tipo usado; o segundo sufixo é i32 ou i64, que indica se o dimensionar do arquivo é representado sistema autônomo um inteiro de 32 bit ou 64 bit.

In Visual C++ 2005, _stat is equivalent to _stat64i32, and struct _stat contains a 64-bit time.This is true unless _USE_32BIT_TIME_T is defined, in which case the old behavior is in effect; _stat uses a 32-bit time, and struct _stat contains a 32-bit time.O mesmo vale para _stati64.

Esta função valida os parâmetros.Se qualquer um dos path ou buffer é NULL, o manipulador de parâmetro inválido é invocado, sistema autônomo descrito em Validação de parâmetro.

Tipo de time e arquivo length tipo variações de _stat

Mapeamentos de rotina de texto genérica

The _stat estrutura, definida no SYS\STAT.H, inclui os seguintes campos.

• st_gid
  Identificador numérico do agrupar que possui o arquivo (específico do UNIX) Este campo será sempre zero nos sistemas Windows.Um arquivo redirecionado é classificado sistema autônomo um arquivo do Windows.

• st_atime
  time do último acesso de arquivo.Válido em NTFS, mas não em FAT formatado drives de disco.

• st_ctime
  time de criação de arquivo.Válido em NTFS, mas não em FAT formatado drives de disco.

• st_dev
  Número do disco que contém o arquivo (mesmo que da unidadest_rdev).

• st_ino
  Número do nó informações (o inode) para o arquivo (específico do UNIX). Em sistemas de arquivos UNIX, a inode Descreve a data do arquivo e carimbos de data / time, permissões e conteúdo. Quando arquivos são vinculados ao disco rígido uns aos outros, eles compartilham o mesmo inode. The inodee, portanto, st_ino, não tem significado em sistemas de arquivos FAT, HPFS ou NTFS.

• st_mode
  Máscara de bit para informações sobre o modo de arquivo.The _S_IFDIR bit é conjunto se path Especifica um diretório; o _S_IFREG bit é conjunto se path Especifica um arquivo comum ou um dispositivo. Bits de leitura/gravar do usuário são definidas de acordo com o modo de permissão do arquivo; usuário executar bits forem definidos de acordo com a extensão de nome de arquivo.

• st_mtime
  time da última modificação do arquivo.

• st_nlink
  Sempre 1 em sistemas de arquivos não-NTFS.

• st_rdev
  Número do disco que contém o arquivo (mesmo que da unidadest_dev).

• st_size
  dimensionar do arquivo em bytes; um inteiro de 64 bit para variações com o i64 sufixo**.**

• st_uid
  Identificador numérico do usuário que é proprietário de arquivo (específico do UNIX).Este campo será sempre zero nos sistemas Windows.Um arquivo redirecionado é classificado sistema autônomo um arquivo do Windows.

If path refere-se a um dispositivo, o st_size, vários campos de time, st_dev, e st_rdev campos na _stat estrutura fazem sentido. Como STAT.H usa o _dev_t tipo definido no TYPES.H, você deve incluir TYPES.H antes STAT.H em seu código.

Requisitos

Para obter informações adicionais compatibilidade, consulte Compatibilidade na introdução.

Exemplo

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

Equivalente do NET Framework

• sistema::IO::arquivo::GetAttributes

• sistema::IO::arquivo::GetCreationTime

• sistema::IO::arquivo::GetLastAccessTime

• sistema::IO::arquivo::GetLastWriteTime

Consulte também

Referência

Manipulação de arquivos

_access, _waccess

_fstat, _fstat32, _fstat64, _fstati64, _fstat32i64, _fstat64i32

_getmbcp

_setmbcp