_fstat, _fstat32, _fstat64, _fstati64, _fstat32i64, _fstat64i32

Artigo
06/09/2015

Obtém informações sobre um arquivo aberto.

int _fstat( 
   int fd,
   struct _stat *buffer 
);
int _fstat32( 
   int fd,
   struct __stat32 *buffer 
);
int _fstat64( 
   int fd,
   struct __stat64 *buffer 
);
int _fstati64( 
   int fd,
   struct _stati64 *buffer 
);
int _fstat32i64( 
   int fd,
   struct _stat32i64 *buffer 
);
int _fstat64i32( 
   int fd,
   struct _stat64i32 *buffer 
);

Parâmetros

fd
O descritor do Arquivo aberto.
buffer
Ponteiro para a estrutura para armazenar os resultados.

Valor de retorno

Retornará 0 se as informações de status arquivo é obtida. Um valor de retorno – 1 indica um erro. Se o descritor de arquivo for inválido ou buffer é NULL, o manipulador inválido do parâmetro será chamado, conforme descrito em Validação do parâmetro. Se a execução for permitida continuar, errno está definido como EBADF, no caso de um descritor de arquivo inválido, ou a EINVAL, se buffer é NULL.

Comentários

A função de _fstat obtém informações sobre o arquivo aberto associado a fd e armazená-las na estrutura apontada por buffer. A estrutura de _stat , definida no sistema \ Stat.h, contém os seguintes campos.

st_atime
Hora do acesso ao arquivo o último.
st_ctime
Hora de criação do arquivo.
st_dev
Se um dispositivo, fd; se não 0.
st_mode
Máscara de bits para obter informações sobre o modo de arquivo. O bit de _S_IFCHR é definido como se fd se refere a um dispositivo. O bit de _S_IFREG é definido como se fd se refere a um arquivo comum. Os bits de leitura/gravação são definidos de acordo com o modo de permissões do arquivo. _S_IFCHR e outras constantes são definidos no sistema \ Stat.h.
st_mtime
Hora da última modificação do arquivo.
st_nlink
Sempre 1 em sistemas de arquivos não NTFS.
st_rdev
Se um dispositivo, fd; se não 0.
st_size
Tamanho do arquivo em bytes.

Se fd se refere a um dispositivo, st_atime, st_ctime, st_mtime, e os campos de st_size não são significativos.

Como Stat.h usa o tipo de _dev_t , que é definido em Types.h, você deve incluir Types.h antes de Stat.h em seu código.

_fstat64, que usa a estrutura de __stat64 , permite que as datas de arquivo criar são expressas anterior a 23:59: o 31 de dezembro, 59, 3000, UTC; enquanto as outras funções representam apenas datas a 03:14: 7 de janeiro de 19, 2038, UTC. A meia-noite, o 1º de janeiro de 1970, é o limite inferior do intervalo de datas para todas essas funções.

Variações dessas funções oferecem suporte a tipos de 32 bits ou de 64 bits de tempo e comprimentos de 32 bits ou de 64 bits de arquivo. O primeiro sufixo numérico (32 ou 64) indica o tamanho do tipo de tempo usado; o segundo sufixo é i32 ou i64, indicando se o tamanho do arquivo é representado como um inteiro de 32 bits ou de 64 bits.

_fstat é equivalente a _fstat64i32, e struct_stat contém um horário de 64 bits. Isso é verdadeiro _USE_32BIT_TIME_T a menos que seja definido nesse caso, o comportamento anterior é aplicado; _fstat usa um horário de 32 bits, e struct_stat contém um horário de 32 bits. O mesmo é válido para _fstati64.

Hora em que o tipo e arquiva variações do tipo de comprimento de _stat

Funções	_USE_32BIT_TIME_T definido?	Tipo de tempo	Tipo de tamanho de Arquivo
_fstat	Não definido	64 bits	32 bits
_fstat	Definido	32 bits	32 bits
_fstat32	Não afetado pela definição macro	32 bits	32 bits
_fstat64	Não afetado pela definição macro	64 bits	64 bits
_fstati64	Não definido	64 bits	64 bits
_fstati64	Definido	32 bits	64 bits
_fstat32i64	Não afetado pela definição macro	32 bits	64 bits
_fstat64i32	Não afetado pela definição macro	64 bits	32 bits

Requisitos

Função	Cabeçalho necessário
_fstat	<o sistema/stat.h e> sistema </types.h>
_fstat32	<o sistema/stat.h e> sistema </types.h>
_fstat64	<o sistema/stat.h e> sistema </types.h>
_fstati64	<o sistema/stat.h e> sistema </types.h>
_fstat32i64	<o sistema/stat.h e> sistema </types.h>
_fstat64i32	<o sistema/stat.h e> sistema </types.h>

Para obter mais informações sobre compatibilidade, consulte Compatibilidade na Introdução.

Exemplo

// crt_fstat.c
// This program uses _fstat to report
// the size of a file named F_STAT.OUT.
 

#include <io.h>
#include <fcntl.h>
#include <time.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <errno.h>
#include <share.h>

int main( void )
{
   struct _stat buf;
   int fd, result;
   char buffer[] = "A line to output";
   char timebuf[26];
   errno_t err;

   _sopen_s( &fd,
             "f_stat.out",
             _O_CREAT | _O_WRONLY | _O_TRUNC,
             _SH_DENYNO,
             _S_IREAD | _S_IWRITE );
   if( fd != -1 )
      _write( fd, buffer, strlen( buffer ) );

   // Get data associated with "fd": 
   result = _fstat( fd, &buf );

   // Check if statistics are valid: 
   if( result != 0 )
   {
      if (errno == EBADF)
        printf( "Bad file descriptor.\n" );
      else if (errno == EINVAL)
        printf( "Invalid argument to _fstat.\n" );
   }
   else
   {
      printf( "File size     : %ld\n", buf.st_size );
      err = ctime_s(timebuf, 26, &buf.st_mtime);
      if (err)
      {
         printf("Invalid argument to ctime_s.");
         exit(1);
      }
      printf( "Time modified : %s", timebuf );
   }
   _close( fd );
}