Función de biblioteca C -rename()

Biblioteca estándar de C - <stdio.h>

rename() es la función de la biblioteca estándar de C utilizada pararenombrar archivos o directorios.

rename() se define en el archivo de cabecera <stdio.h>.

Función de biblioteca Cint rename(const char *old_filename, const char *new_filename)tomarold_filenameel nombre del archivo al que apunta se cambia anew_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-- Nombre de archivo original (si incluye una ruta, debe proporcionar la ruta completa).
  • new_filename-- new_filename: nuevo nombre de archivo (también puede incluir una ruta).

Valor de retorno

  • 0: ejecución exitosa (el archivo/directorio se renombró correctamente).
  • Distinto de 0: ejecución fallida (las causas de error comunes incluyen permisos insuficientes, archivo inexistente, el destino ya existe, etc.).

Notas de uso

El archivo debe existir; de lo contrario, se devolverá un error.

Si el archivo de destino new_filename ya existe, el comportamiento puede variar según el sistema:

  • En la mayoría de los sistemas Unix/Linux, rename() sobrescribirá directamente el archivo de destino.
  • En Windows, si el archivo de destino existe, rename() fallará.

No se puede renombrar entre distintos puntos de montaje (particiones/dispositivos).

Ejemplo

El siguiente ejemplo demuestra el uso de la función rename().

Ejemplo

#include <stdio.h>

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

   if(ret == 0)  {
      printf(Archivo renombrado con éxito);
   } else   {
      printf(Error: no se pudo renombrar el archivo);
   }
   
   return(0);
}

Supongamos que tenemos un archivo de textofile.txt, su contenido es el siguiente. Usaremos el programa anterior para renombrar dicho archivo. Compilemos y ejecutemos el programa anterior; esto generará el siguiente mensaje y el archivo se renombrará anewfile.txtarchivo.

Archivo renombrado correctamente.

Biblioteca estándar de C - <stdio.h>

Otras extensiones