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
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