_utime, _wutime

Nach oben zu utime.h - Index

Header-Datei

utime.h

Kategorie

Eingabe-/Ausgaberoutinen

Prototyp

int _utime(char *path, struct utimbuf *times);

int _wutime(wchar_t *path, struct _utimbuf *times);

Beschreibung

Setzt Datum und Zeit einer Datei.

_utime setzt den Änderungszeitpunkt der in path angegebenen Datei. Der Änderungszeitpunkt ist in der Struktur utimbuf enthalten, auf die times zeigt. Diese Struktur ist in utime.h definiert und hat folgendes Format:

struct utimbuf {

time_t actime; /* Zugriffszeitpunkt */

time_t modtime; /* Änderungszeitpunkt */

};

Das FAT-Dateisystem (File Allocation Table) unterstützt nur den Änderungszeitpunkt; daher ignoriert _utime bei einem FAT-Dateisystem das Feld actime und verwendet nur modtime, um den Änderungszeitpunkt für die Datei zu setzen.

Ist times NULL, wird die aktuelle Uhrzeit als Änderungszeitpunkt für die Datei gesetzt.

_wutime ist die Unicode-Version von _utime. Die Unicode-Version akzeptiert einen Zeichenstring vom Typ wchar_t als Dateinamen. Ansonsten haben die Funktionen das gleiche Verhalten.

Rückgabewert

Wenn erfolgreich, gibt _utime 0 zurück.

Andernfalls gibt die Funktion -1 zurück und weist der globalen Variablen errno einen der folgenden Werte zu:

EACCES	Permission denied (Zugriff verweigert)
EMFILE	Too many open files (Zu viele Dateien geöffnet)
ENOENT	Path or file name not found (Pfad oder Dateiname nicht gefunden)

Beispiel

 /* Zeitangaben einer Datei auf eine andere Datei kopieren */
 #include <sys\stat.h>;
 #include <utime.h>
 #include <stdio.h>
 
 int main( int argc, char *argv[] )
 {
   struct stat src_stat;
   struct utimbuf times;
   if(argc != 3) {
     printf( "Usage: copytime <source file> <dest file>\n" );
     return 1;
   }
 
   if (stat(argv[1],&src_stat) != 0) {
     perror("Unable to get status of source file");
     return 1;
   }
 
   times.modtime = times.actime = src_stat.st_mtime;
   if (utime(argv[2],&times) != 0) {
     perror("Unable to set time of destination file");
     return 1;
   }
   return 0;
 }

Portabilität

	POSIX	Win32	ANSI C	ANSI C++
_utime	+	+
_wutime		+