CKTIS / C
rename — zmiana nazwy pliku
Funkcja rename z <stdio.h> zmienia nazwę pliku. Zwraca 0 przy powodzeniu, a wartość niezerową przy błędzie.
Wersja: C23; repository compiler flag, production runtime not attested
Składnia
#include <stdio.h>
int rename(const char *old, const char *new);rename(old, new) przyjmuje dwa napisy zakończone znakiem zerowym: dotychczasową i nową nazwę pliku. Po powodzeniu plik nie jest już dostępny pod starą nazwą.
Jeśli cel już istnieje, zachowanie jest zdefiniowane przez implementację: nie zakładaj przenośnego nadpisywania. Przy błędzie istniejący plik źródłowy zachowuje pierwotną nazwę.
Operacja może się nie udać między innymi wtedy, gdy plik jest otwarty lub zmiana nazwy wymaga kopiowania zawartości. Przykład zamyka plik przed zmianą nazwy i sprawdza wynik przez != 0, nie przez == -1.
Przykłady
#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;
}Wynik
Renamed and removed.
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.