CKTIS / C
rename — eine Datei umbenennen
Die Funktion rename aus <stdio.h> ändert den Namen einer Datei. Bei Erfolg gibt sie 0 zurück, bei einem Fehler einen Wert ungleich null.
Version: C23; repository compiler flag, production runtime not attested
Syntax
#include <stdio.h>
int rename(const char *old, const char *new);rename(old, new) erwartet zwei nullterminierte Zeichenketten: den bisherigen und den neuen Dateinamen. Nach erfolgreichem Aufruf ist die Datei nicht mehr unter ihrem alten Namen verfügbar.
Wenn das Ziel bereits existiert, ist das Verhalten implementierungsdefiniert: Gehe nicht davon aus, dass die Datei portabel ersetzt wird. Bei einem Fehler behält eine vorhandene Quelldatei ihren ursprünglichen Namen.
Der Vorgang kann beispielsweise fehlschlagen, wenn die Datei geöffnet ist oder das Umbenennen das Kopieren ihres Inhalts erfordert. Das Beispiel schließt die Datei vor dem Umbenennen und prüft das Ergebnis mit != 0, nicht mit == -1.
Beispiele
#include <stdio.h>
#include <stdlib.h>
int main(void)
{
/* Run in a private directory where no other process changes these names. */
FILE *file = fopen("rename-before.txt", "wx");
if (file == NULL) {
return EXIT_FAILURE;
}
if (fclose(file) != 0) {
return EXIT_FAILURE;
}
/* Reserve the destination without opening or truncating an existing file. */
FILE *destination = fopen("rename-after.txt", "wx");
if (destination == NULL) {
return EXIT_FAILURE;
}
if (fclose(destination) != 0) {
remove("rename-after.txt");
return EXIT_FAILURE;
}
/* Some implementations do not allow rename to replace the placeholder. */
if (rename("rename-before.txt", "rename-after.txt") != 0) {
remove("rename-after.txt");
return EXIT_FAILURE;
}
if (remove("rename-after.txt") != 0) {
return EXIT_FAILURE;
}
puts("Renamed and removed.");
return EXIT_SUCCESS;
}Ergebnis
Renamed and removed.
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.