_futime
, _futime32
, _futime64
Define o tempo de modificação em um arquivo aberto.
Sintaxe
int _futime(
int fd,
struct _utimbuf *filetime
);
int _futime32(
int fd,
struct __utimbuf32 *filetime
);
int _futime64(
int fd,
struct __utimbuf64 *filetime
);
Parâmetros
fd
Descritor de arquivo do arquivo aberto.
filetime
Ponteiro para a estrutura que contém a nova data de modificação.
Valor retornado
Retorna 0 se for bem-sucedido. Se ocorrer um erro, o manipulador de parâmetro inválido será invocado, conforme descrito em Validação de parâmetro. Se a execução tiver permissão para continuar, a função retornará -1 e errno
será definida como EBADF
, indicando um descritor de arquivo inválido ou EINVAL
, indicando um parâmetro inválido.
Comentários
A _futime
rotina define a data de modificação e o tempo de acesso no arquivo aberto associado ao fd
. _futime
é idêntico a _utime
, exceto que seu argumento é o descritor de arquivo de um arquivo aberto, em vez do nome de um arquivo ou um caminho para um arquivo. A estrutura _utimbuf
contém campos para a nova data de modificação e a hora de acesso. Os dois campos devem conter valores válidos. _utimbuf32
e _utimbuf64
são idênticos a _utimbuf
, exceto pelo uso dos tipos de hora de 32 bits e 64 bits, respectivamente. _futime
e _utimbuf
usam um tipo de hora de 64 bits e _futime
é idêntico ao comportamento de _futime64
. Se precisar forçar o comportamento antigo, defina _USE_32BIT_TIME_T
. Fazer isso faz com que _futime
tenha um comportamento idêntico ao de _futime32
e faz com que a estrutura _utimbuf
use o tipo de hora de 32 bits, tornando-o equivalente a __utimbuf32
.
_futime64
, que usa a estrutura __utimbuf64
, pode ler e modificar datas de arquivo até 23:59:59 de 31 de dezembro de 3000, UTC; enquanto uma chamada para _futime32
falhará se a data no arquivo for posterior a 23:59:59 de 18 de janeiro de 2038, UTC. Meia-noite de 1º de janeiro de 1970 é o limite inferior do intervalo de datas para essas funções.
Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, confira Estado global no CRT.
Requisitos
Função | Cabeçalho necessário | Cabeçalho opcional |
---|---|---|
_futime |
<sys/utime.h> | <errno.h> |
_futime32 |
<sys/utime.h> | <errno.h> |
_futime64 |
<sys/utime.h> | <errno.h> |
Para obter informações sobre compatibilidade, consulte Compatibilidade.
Exemplo
// crt_futime.c
// This program uses _futime to set the
// file-modification time to the current time.
#include <stdio.h>
#include <stdlib.h>
#include <fcntl.h>
#include <io.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <sys/utime.h>
#include <share.h>
int main( void )
{
int hFile;
// Show file time before and after.
system( "dir crt_futime.c_input" );
_sopen_s( &hFile, "crt_futime.c_input", _O_RDWR, _SH_DENYNO, 0 );
if( _futime( hFile, NULL ) == -1 )
perror( "_futime failed\n" );
else
printf( "File time modified\n" );
_close (hFile);
system( "dir crt_futime.c_input" );
}
Entrada: crt_futime.c_input
Arbitrary file contents.
Saída de exemplo
Volume in drive Z has no label.
Volume Serial Number is 5C68-57C1
Directory of Z:\crt
03/25/2004 10:40 AM 24 crt_futime.c_input
1 File(s) 24 bytes
0 Dir(s) 24,268,476,416 bytes free
Volume in drive Z has no label.
Volume Serial Number is 5C68-57C1
Directory of Z:\crt
03/25/2004 10:41 AM 24 crt_futime.c_input
1 File(s) 24 bytes
0 Dir(s) 24,268,476,416 bytes free
File time modified