Función de biblioteca C - renombrar ()

Descripción

La función de la biblioteca C int rename(const char *old_filename, const char *new_filename) hace que el nombre de archivo al que hace referencia old_filename ser cambiado a new_filename.

Declaración

A continuación se muestra la declaración de la función rename ().

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

Parámetros

  • old_filename - Esta es la cadena C que contiene el nombre del archivo que se cambiará de nombre y / o moverá.

  • new_filename - Esta es la cadena C que contiene el nuevo nombre del archivo.

Valor devuelto

En caso de éxito, se devuelve cero. En caso de error, se devuelve -1 y errno se establece de forma adecuada.

Ejemplo

El siguiente ejemplo muestra el uso de la función 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);
}

Supongamos que tenemos un archivo de texto. file.txt, tener algo de contenido. Entonces, vamos a cambiar el nombre de este archivo, usando el programa anterior. Compilemos y ejecutemos el programa anterior para producir el siguiente mensaje y se cambiará el nombre del archivo anewfile.txt archivo.

File renamed successfully