CKTIS / C
rename — renommer un fichier
La fonction rename de <stdio.h> modifie le nom d’un fichier. Elle renvoie 0 en cas de réussite et une valeur non nulle en cas d’échec.
Version : C23; repository compiler flag, production runtime not attested
Syntaxe
#include <stdio.h>
int rename(const char *old, const char *new);rename(old, new) prend deux chaînes terminées par un caractère nul : l’ancien nom du fichier et son nouveau nom. En cas de réussite, le fichier n’est plus accessible sous son ancien nom.
Si la destination existe déjà, le comportement dépend de l’implémentation : ne supposez pas qu’un remplacement soit portable. En cas d’échec, un fichier source existant conserve son nom d’origine.
L’opération peut échouer, par exemple, si le fichier est ouvert ou si le changement de nom nécessite de copier son contenu. L’exemple ferme le fichier avant de le renommer et teste le résultat avec != 0, et non avec == -1.
Exemples
#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;
}Résultat
Renamed and removed.
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.