utime - ファイルの時刻情報の設定

【書式】

#include <io.h>

int utime(const char *pathname, const time_t times[2]);

【解説】

utime()は、pathnameが示すファイルの時刻情報をtimes[1] の時刻に変更し

ます。時刻の表現はtime(3)の返す値と同じです。

timesにNULLを指定すると、ファイルには現在の時刻が設定されます。

【リターン値】

成功すれば 0を返します。失敗するとerrnoをセットし、0以外の値を返しま

す。

【エラー】

EACCES

pathnameはディレクトリ、またはリードオンリーファイルです

EMFILE

オープンされているファイルの数が多すぎます

ENOENT

pathnameで示されるファイル、あるいは先行するパス名が存在しません

【可搬性】

UNIX, DOS窓

【参照】

gftime(3), time(3)

【バグ】

utime()ではディレクトリの時刻情報を設定することはできません。 これは

DOS窓の制限です。

【copyright (c) 安江正樹@東海大学理学部物理学科】