Fonctions de bibliothèque C -rename()

Bibliothèque standard C - <stdio.h>

rename() est une fonction de la bibliothèque standard C utilisée pourRenommer un fichier ou un répertoirede la fonction.

rename() est définie dans le fichier d'en-tête <stdio.h>.

Fonctions de la bibliothèque Cint rename(const char *old_filename, const char *new_filename)conserverold_filenameLe nom du fichier vers lequel il pointe est remplacé parnew_filename。

Déclaration

Ci-dessous se trouve la déclaration de la fonction rename().

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

Paramètre

  • old_filename-- Le nom de fichier d'origine (s'il contient un chemin, le chemin complet doit être fourni).
  • new_filenamenew_filename : le nouveau nom de fichier (peut être un chemin).

Valeur de retour

  • 0: Exécution réussie (fichier/répertoire renommé avec succès).
  • Non-zéro: échec de l'exécution (les causes courantes incluent des permissions insuffisantes, l'absence du fichier, l'existence préalable de la cible, etc.).

Notes d'utilisation

Le fichier doit exister ; sinon, une erreur sera renvoyée.

Si le fichier cible new_filename existe déjà, différents systèmes peuvent le gérer différemment :

  • Sur la plupart des systèmes Unix/Linux, rename() écrasera directement le fichier cible.
  • Sous Windows, si le fichier cible existe, rename() échouera.

Impossible de renommer entre différents points de montage (partitions/périphériques).

Exemple

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

Exemple

#include <stdio.h>

int main () {
   int ret;
   char oldname[] = "file.txt";
   char newname[] = "newfile.txt";
   
   ret = rename(oldname, newname);

   if(ret == 0)  {
      printf("Fichier renommé avec succès");
   } else   {
      printf("Erreur : impossible de renommer le fichier");
   }
   
   return(0);
}

Supposons que nous ayons un fichier textefile.txt, dont le contenu est le suivant. Nous allons utiliser le programme ci-dessus pour renommer le fichier. Compilons et exécutons le programme ci-dessus, qui générera le message suivant, et le fichier sera renommé ennewfile.txtFichier.

File renamed successfully.

Bibliothèque standard C - <stdio.h>

autres extensions