CKTIS / C
rename — rinominare un file
La funzione rename di <stdio.h> cambia il nome di un file. Restituisce 0 in caso di successo e un valore diverso da zero in caso di errore.
Versione: C23; repository compiler flag, production runtime not attested
Sintassi
#include <stdio.h>
int rename(const char *old, const char *new);rename(old, new) accetta due stringhe terminate da un carattere nullo: il nome attuale del file e quello nuovo. Se l’operazione riesce, il file non è più accessibile con il nome precedente.
Se la destinazione esiste già, il comportamento è definito dall’implementazione: non dare per scontato che la sostituzione sia portabile. In caso di errore, un file sorgente esistente mantiene il nome originale.
L’operazione può fallire, per esempio, se il file è aperto o se rinominarlo richiede di copiarne il contenuto. L’esempio chiude il file prima di rinominarlo e verifica il risultato con != 0, non con == -1.
Esempi
#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;
}Risultato
Renamed and removed.
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.