Программирование на C и C++

Онлайн справочник программиста на C и C++

utime

int utime(char *fname, struct utimbuf *t)

Прототип: 
Описание: 

Эта функция не определена стандартом ANSI С.

Функция utime() изменяет время создания (или последней модификации) файла, чье имя опре­деляется указателем fname. Новое время задается структурой, на которую указывает параметр t. Структура utimbuf определена следующим образом:

struct utimbuf {
time_t actime;
time_t modtime;
};

Поле actime не относится к DOS. Если параметр t имеет значение NULL, то время создания файла устанавливается равным текущему времени системы.

Функция utime() в случае успеха возвращает 0. При возникновении ошибки возвращается зна­чение — 1, а переменная errno устанавливается в одно из следующих значений:

Макрос Значение
EACCESS Доступ запрещен
EMFILE Слишком много открытых файлов
ENOENT Файл не существует
Пример: 
Следующая программа устанавливает время создания заданного файла равным текущему времени системы. (Это простая версия утилиты TOUCH.)
#include <utime.h>
#include <stdio.h>
int main(int argc, char *argv[])
{
if (argc != 2) {
printf("Usage: SETTIME <fname>");
return 1;
}

/* установка текущего времени */
utime(argv[1], NULL);
return 0;
}