4.19 utime函数-文件时间修改

除了文件处理函数隐性地处理文件时间属性外，很多时候应用程序需要显式地处理时间属性，例如更改文件的时间属性，用文件的时间属性作为一个事务处理的依据，有时候还要将时间变成让人看懂的字符打印出来。

一、utime函数：

utime函数用于直接修改一个文件的时间属性：stat.st_atime（数据的最后访问时间）、stat.st_mtime（数据的最后修改时间）。（参考《4.2 stat函数》）

utime函数原型如下：

#include <utime.h>
int utime(const char *pathname, const struct utimbuf *times);

返回值：若成功则返回0 ，若失败则返回-1

参数：

pathname 文件路径

times 要修改为的新时间值，是utimebuf结构类型。

utimbuf结构如下：

struct utimbuf {
    time_t actime; /*access time */
    time_t modtime; /*modification time */
}

utimebuf结构体中的两个成员actime和modtime都是日历时间（参考《4.18 文件的时间属性》）。

与前面修改文件的管理属性一样，修改文件的时间属性也都需要一定的特权：这个特权决定于times参数是否为NULL。

1、如果times是一个空指针，则访问时间和修改时间两个都设置为当前时间。此时，执行权限是以下两个条件之一：

（a）进程的有效用户ID必须等于该文件的所有者ID；

（b）进程对该文件拥有写权限。

2、如果times是非空指针，则访问时间和修改时间被设置为times所指向结构体的值。此时，执行权限是以下两个条件之一：

（a）进程的有效用户ID必须等于该文件的所有者ID（只是拥有写权限还不够）；

（b）进程必须是超级用户进程。

实例 x.4.19.1.c

#include <utime.h>
#include <sys/stat.h>
#include <stdio.h>
#include <stdlib.h>

#define oneday (60 * 60 * 24)
int main(int argc, char *argv[])
{
    char              pathname[] = "/tmp/myfile";
    struct stat       statbuf;
    struct utimbuf   timebuf;

    if (stat(pathname, &statbuf) == -1) {
        printf("stat error for %s\n", pathname);
    } else {
        timebuf.modtime = statbuf.st_mtime - oneday * 3; /*最后修改时间减3天*/
        timebuf.actime = statbuf.st_atime - oneday;/*最后访问时间减1天*/
        if (utime(pathname, &timebuf) == -1)   /*修改时间*/
        printf("utime error for %s\n", pathname);
    }   

    exit(0);

}

编译与执行：

[root@localhost unixc]# echo "123456789" > /tmp/myfile
[root@localhost unixc]# ls -l /tmp/myfile
----r-S--T. 2 root root 10 Nov  4 23:05 /tmp/myfile
[root@localhost unixc]# ./a.out
[root@localhost unixc]# ls -l /tmp/myfile
----r-S--T. 2 root root 10 Nov  2 00:05 /tmp/myfile
[root@localhost unixc]#

分析：实例先取文件原来的时间，然后加上一定量的时间（是个大约数），这些时间计算都是原始的日历时间上进行。要对时间进行处理，还得用很多时间处理函数，例如时间本地化处理函数localtime等待。

修改文件时间的一般步骤是：

（1）取文件原来的时间；

（2）将日历时间转换为本地时间或者国际标准时间；

（3）对本地时间进行时间加减乘除运算；

（4）将本地时间转换为日历时间；

（5）用utime函数更改文件时间。