utime

utime 模块提供设置文件访问时间和修改时间的能力。

头文件清单

#include "open_source/musl/include/utime.h"

接口清单

接口名称	功能简述
utime	设置文件的访问时间和修改时间

Functions

utime

函数声明

int utime(const char *, const struct utimbuf *)

头文件清单

#include "open_source/musl/include/utime.h"

功能说明

• 设置指定文件的访问时间和修改时间
• 通过传入utimbuf结构体指定新的访问时间和修改时间
• 当ptimes参数为NULL时，使用当前系统时间设置文件的访问时间和修改时间

入参

名称	参数类型	详细说明	约束取值范围
path	const char *	文件路径字符串指针	非NULL，非空字符串
ptimes	const struct utimbuf *	包含访问时间和修改时间的结构体指针	NULL或指向有效的utimbuf结构体

返回值

• 返回类型：int

返回值	文字含义	触发场景
0	执行成功	文件时间修改成功
-1	执行失败	path为NULL、路径为空、路径无效、文件不存在、权限不足或操作不支持

Structures

utimbuf

struct utimbuf {
    time_t actime;
    time_t modtime;
};

成员说明

成员名称	数据类型	描述
actime	time_t	文件访问时间
modtime	time_t	文件修改时间