CKTIS / C
rename — preimenovanje datoteke
Funkcija rename iz <stdio.h> spremeni ime datoteke. Ob uspehu vrne 0, ob napaki pa vrednost, ki ni enaka nič.
Različica: C23; repository compiler flag, production runtime not attested
Sintaksa
#include <stdio.h>
int rename(const char *old, const char *new);rename(old, new) sprejme dva niza, zaključena z ničelnim znakom: trenutno ime datoteke in novo ime. Po uspešnem klicu datoteka ni več dostopna pod starim imenom.
Če cilj že obstaja, je vedenje odvisno od implementacije: ne predpostavljajte, da bo zamenjava delovala prenosljivo. Ob napaki obstoječa izvorna datoteka ohrani svoje prvotno ime.
Operacija lahko na primer spodleti, če je datoteka odprta ali če je za preimenovanje treba kopirati njeno vsebino. Primer datoteko pred preimenovanjem zapre in rezultat preveri z != 0, ne z == -1.
Primeri
#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;
}Rezultat
Renamed and removed.
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.