CKTIS / C
rename — преименуване на файл
Функцията rename от <stdio.h> променя името на файл. При успех връща 0, а при грешка — ненулева стойност.
Версия: C23; repository compiler flag, production runtime not attested
Синтаксис
#include <stdio.h>
int rename(const char *old, const char *new);rename(old, new) приема два низа, завършващи с нулев знак: текущото име на файла и новото име. След успешното изпълнение файлът вече не е достъпен под старото си име.
Ако целевият файл вече съществува, поведението се определя от реализацията: не приемайте, че замяната ще е преносима. При грешка съществуващият изходен файл запазва първоначалното си име.
Операцията може да се провали например ако файлът е отворен или ако преименуването изисква копиране на съдържанието му. Примерът затваря файла преди преименуването и проверява резултата с != 0, а не с == -1.
Примери
#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;
}Резултат
Renamed and removed.
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.