### Linux服务器编程之utime()与utimes()函数详解
#### 概述
在Linux服务器编程中，我们经常需要对文件的时间属性进行操作，比如修改文件的最后访问时间和最后修改时间。这不仅可以帮助我们更好地管理文件系统，还能在某些特定的应用场景中发挥重要作用。本文将详细介绍`utime()`和`utimes()`这两个函数的功能、使用方法及其注意事项。
#### utime() 函数
**定义**: `utime()`函数用于修改文件的最后访问时间和最后修改时间。如果提供的缓冲区`buf`为`NULL`，则这两个时间都将设置为当前时间。
**头文件**:
```c
#include <sys/types.h>
#include <utime.h>
```
**函数原型**:
```c
int utime(const char *filename, struct utimbuf *buf);
```
**参数**:
- `filename`: 要修改时间的文件名。
- `buf`: 包含新的最后访问时间和最后修改时间的结构体指针。
**结构体定义**:
```c
struct utimbuf {
time_t actime; // 最后访问时间
time_t modtime; // 最后修改时间
};
```
**返回值**:
- 成功时返回0；
- 失败时返回-1，并将错误码存储在`errno`中。
**错误码**:
- `EACCES`: 存取文件时权限不足。
- `ENOENT`: 指定的文件不存在。
**示例**:
```c
#include <sys/types.h>
#include <utime.h>
#include <stdio.h>
int main() {
struct utimbuf times;
times.actime = time(NULL); // 设置为当前时间
times.modtime = time(NULL) - 3600; // 设置为一小时前
if (utime("example.txt", ×) == -1) {
perror("Error");
return 1;
}
printf("Times set successfully.\n");
return 0;
}
```
#### utimes() 函数
**定义**: `utimes()`函数类似于`utime()`，但使用`timeval`结构来表示时间，提供了更精确的时间控制能力。
**头文件**:
```c
#include <sys/types.h>
#include <utime.h>
```
**函数原型**:
```c
int utimes(const char *filename, const struct timeval times[2]);
```
**参数**:
- `filename`: 要修改时间的文件名。
- `times`: 包含新的最后访问时间和最后修改时间的`timeval`数组。
**结构体定义**:
```c
struct timeval {
long tv_sec; // 秒
long tv_usec; // 微秒
};
```
**返回值**:
- 成功时返回0；
- 失败时返回-1，并将错误码存储在`errno`中。
**错误码**:
- `EACCES`: 存取文件时权限不足。
- `ENOENT`: 指定的文件不存在。
**示例**:
```c
#include <sys/types.h>
#include <utime.h>
#include <stdio.h>
int main() {
struct timeval times[2];
times[0].tv_sec = time(NULL); // 最后访问时间
times[0].tv_usec = 0;
times[1].tv_sec = time(NULL) - 3600; // 最后修改时间为一小时前
times[1].tv_usec = 0;
if (utimes("example.txt", times) == -1) {
perror("Error");
return 1;
}
printf("Times set successfully.\n");
return 0;
}
```
#### 总结
通过上述介绍可以看出，`utime()`和`utimes()`函数为我们提供了修改文件最后访问时间和最后修改时间的能力。虽然它们的使用方法略有不同，但在实际开发中可以根据具体需求选择合适的方法。需要注意的是，在操作文件时间时应确保有足够的权限，避免因权限问题导致操作失败。
正确地使用这些函数能够帮助我们在Linux环境下更灵活地管理和操作文件系统，提高程序的灵活性和可靠性。
