Fonction de bibliothèque C - renommer ()

La description

La fonction de bibliothèque C int rename(const char *old_filename, const char *new_filename) provoque le nom de fichier référencé par old_filename à changer en new_filename.

Déclaration

Voici la déclaration de la fonction rename ().

int rename(const char *old_filename, const char *new_filename)

Paramètres

  • old_filename - Il s'agit de la chaîne C contenant le nom du fichier à renommer et / ou à déplacer.

  • new_filename - Il s'agit de la chaîne C contenant le nouveau nom du fichier.

Valeur de retour

En cas de succès, zéro est renvoyé. En cas d'erreur, -1 est renvoyé et errno est défini de manière appropriée.

Exemple

L'exemple suivant montre l'utilisation de la fonction rename ().

#include <stdio.h>

int main () {
   int ret;
   char oldname[] = "file.txt";
   char newname[] = "newfile.txt";
   
   ret = rename(oldname, newname);
	
   if(ret == 0) {
      printf("File renamed successfully");
   } else {
      printf("Error: unable to rename the file");
   }
   
   return(0);
}

Supposons que nous ayons un fichier texte file.txt, ayant du contenu. Donc, nous allons renommer ce fichier, en utilisant le programme ci-dessus. Compilons et exécutons le programme ci-dessus pour produire le message suivant et le fichier sera renommé ennewfile.txt fichier.

File renamed successfully