Funzione libreria C - rename ()

Descrizione

La funzione di libreria C. int rename(const char *old_filename, const char *new_filename) causa il nome del file a cui fa riferimento old_filename essere cambiato in new_filename.

Dichiarazione

Di seguito è riportata la dichiarazione per la funzione rename ().

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

Parametri

  • old_filename - Questa è la stringa C contenente il nome del file da rinominare e / o spostare.

  • new_filename - Questa è la stringa C contenente il nuovo nome per il file.

Valore di ritorno

In caso di successo, viene restituito zero. In caso di errore, viene restituito -1 e errno viene impostato in modo appropriato.

Esempio

L'esempio seguente mostra l'utilizzo della funzione 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);
}

Supponiamo di avere un file di testo file.txt, con alcuni contenuti. Quindi, rinomineremo questo file, usando il programma sopra. Compiliamo ed eseguiamo il programma sopra per produrre il seguente messaggio e il file verrà rinominatonewfile.txt file.

File renamed successfully