18-utime 函数

utime 函数可以用来更改文件的最近访问时间和最近修改时间，即 atime 和 mtime。如果你不知道这两个时间是什么含义，请参考《stat 结构体中的三个时间》 。

1 utime 函数原型

/*
struct utimbuf {
    time_t actime;       // access time
    time_t modtime;      // modification time
};
*/
int utime(const char *filename, const struct utimbuf *times);

该函数接收一个文件名和 utimbuf 结构体作为输入，返回 0 表示成功，-1 表示失败。

---

2 示例

这个例子将一个文件的 atime 和 mtime 减去一天后，再使用 utime 重设。

2.1 演示

• 创建测试文件

$ echo hello > test.txt
$ ls -ls test.txt
-rw-rw-r-- 1 allen allen 6 12月  1 17:25 test.txt

• 使用 myutime 更改时间（myutime 的代码见 2.2 节）

$ ./myutime test.txt

• 结果

最近修改时间 Thu Dec  1 17:25:17 2016

最近访问时间 Thu Dec  1 17:25:17 2016

执行 utime 后(时间减去一天)
最近修改时间 Wed Nov 30 17:25:17 2016

最近访问时间 Wed Nov 30 17:25:17 2016

---

2.2 完整代码

下面这段代码的知识比较综合，用的都是前面的知识，如果看不懂，建议阅读前面的文章。

代码中有使用新的函数 ctime，该函数是把 time_t 类型的时间转换成人类可读的字符串的，使用起来方便快捷。它的原型是这样的：

char *ctime(const time_t *timep);

---

• 代码

#include <sys/types.h>
#include <sys/stat.h>
#include <time.h>
#include <utime.h>
#include <stdio.h>

int main(int argc, char* argv[]) {
  struct stat st; 
  stat(argv[1], &st);
  printf("最近修改时间 %s\n",ctime(&st.st_mtime)); 
  printf("最近访问时间 %s\n",ctime(&st.st_atime)); 


  struct utimbuf utb = {st.st_atime - 24*3600, st.st_mtime - 24*3600};

  utime(argv[1], &utb);
  stat(argv[1], &st);
  printf("执行 utime 后(时间减去一天)\n");
  printf("最近修改时间 %s\n",ctime(&st.st_mtime)); 
  printf("最近访问时间 %s\n",ctime(&st.st_atime)); 

  return 0;
}

• 编译

$ gcc myutime.c -o myutime

3 总结

• 掌握 utime 的使用方法
• 熟练使用 stat 函数
• 掌握时间转字符串函数 ctime