rename, _wrename

Nach oben zu stdio.h - Index

Header-Datei

stdio.h

Kategorie

Eingabe-/Ausgaberoutinen

Prototyp

int rename(const char *oldname, const char *newname);

int _wrename(const wchar_t *oldname, const wchar_t *newname);

Beschreibung

Benennt eine Datei um.

rename ändert den Namen einer Datei von oldname in newname. Enthält newname eine Laufwerksangabe, muss diese Angabe der Laufwerksangabe in oldname entsprechen.

Die Verzeichnisangaben in oldname und newname müssen nicht identisch sein, so dass mit rename auch eine Datei von einem Verzeichnis in ein anderes verschoben werden kann. Platzhalter sind nicht erlaubt.

Diese Funktion schlägt fehl (EEXIST), wenn ein Prozess die Datei aktuell geöffnet hat.

Rückgabewert

Wenn erfolgreich, gibt rename 0 zurück.

Bei einem Fehler (die Datei kann nicht umbenannt werden) gibt die Funktion -1 zurück, und die globale Variable errno wird auf einen der folgenden Werte gesetzt:

EEXIST	Permission denied (Zugriff verweigert) file already exists (Datei bereits vorhanden)
ENOENT	No such file or directory (Datei oder Verzeichnis nicht gefunden)
ENOTSAM	Not same device (Nicht dasselbe Gerät)

Beispiel

 #include <stdio.h>
 int main(void)
 {
     char oldname[80], newname[80];
     /* Zur Eingabe des alten und des neuen Dateinamens auffordern */
     printf("File to rename: ");
     gets(oldname);
     printf("New name: ");
     gets(newname);
     /* Datei umbenennen */
     if (rename(oldname, newname) == 0)
        printf("Renamed %s to %s.\n", oldname, newname);
     else
        perror("rename");
     return 0;
 }

Portabilität

	POSIX	Win32	ANSI C	ANSI C++
rename	+	+	+	+
_wrename		Nur NT