.- .
设置打开的文件的修改时间。
语法
int _futime(
int fd,
struct _utimbuf *filetime
);
int _futime32(
int fd,
struct __utimbuf32 *filetime
);
int _futime64(
int fd,
struct __utimbuf64 *filetime
);
参数
fd
打开的文件的文件描述符。
filetime
指向包含新修改日期的结构的指针。
返回值
如果成功,则返回 0。 出现错误时,会调用无效参数处理程序,如参数验证中所述。 如果允许执行继续,函数将返回 -1,并且将 errno
设置为 EBADF
(指示文件描述符无效),或设置为 EINVAL
(指示参数无效)。
注解
_futime
例程在与 fd
关联的打开文件上设置修改日期和访问时间。 _futime
等同于 _utime
,只不过其参数是打开的文件的文件描述符,而不是文件的名称或文件的路径名称。 _utimbuf
结构包含新修改日期和访问时间的字段。 这两个字段必须包含有效的值。 _utimbuf32
和 _utimbuf64
等同于 _utimbuf
,只不过分别用于 32 位和 64 位的时间类型。 _futime
和 _utimbuf
使用 64 位时间类型,_futime
的行为等同于 _futime64
。 若要强制旧的非标准行为,请定义 _USE_32BIT_TIME_T
。 这样做,会导致 _futime
的行为等同于 _futime32
,并致使 _utimbuf
结构使用 32 位时间类型,使其等效于 __utimbuf32
。
_futime64
使用 __utimbuf64
结构,可以读取和修改日期截至 3000 年 12 月 31 日 23:59:59 UTC 的文件;如果文件日期晚于 2038 年 1 月 18 日 23:59:59 UTC,则对 _futime32
的调用失败。 1970 年 1 月 1 日午夜是这些函数的日期范围下限。
默认情况下,此函数的全局状态范围限定为应用程序。 若要更改此行为,请参阅 CRT 中的全局状态。
要求
函数 | 必需的标头 | 可选标头 |
---|---|---|
_futime |
<sys/utime.h> | <errno.h> |
_futime32 |
<sys/utime.h> | <errno.h> |
_futime64 |
<sys/utime.h> | <errno.h> |
有关兼容性的详细信息,请参阅 兼容性。
示例
// 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" );
}
输入:crt_futime.c_input
Arbitrary file contents.
示例输出
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