La función rename () en C ++ cambia el nombre de un archivo específico.
renombrar () prototipo
int rename (const char * oldname, const char * newname);
La rename()
función toma dos argumentos: oldname, newname y devuelve un valor entero. Cambia el nombre del archivo representado por la cadena señalada por oldname a la cadena señalada por newname.
Está definido en el archivo de encabezado.
Parámetros rename ()
oldname
: Puntero a la cadena que contiene el nombre antiguo del archivo junto con la ruta para cambiar el nombre.newname
: Puntero a la cadena que contiene el nuevo nombre del archivo junto con la ruta.
rename () Valor de retorno
La función rename () devuelve:
- Cero si el archivo se renombra correctamente.
- Distinto de cero si se produce un error.
Ejemplo 1: Cómo funciona la función rename ()
#include #include using namespace std; int main() ( char oldname() = "file_old.txt"; char newname() = "file_new.txt"; /* Deletes the file if exists */ if (rename(oldname, newname) != 0) perror("Error renaming file"); else cout << "File renamed successfully"; return 0; )
Cuando ejecute el programa, la salida será:
- Si se cambia el nombre del archivo correctamente:
Archivo renombrado correctamente
- Si el archivo no está presente:
Error al cambiar el nombre del archivo: no existe tal archivo o directorio
La rename()
función también se puede utilizar para mover un archivo a una ubicación diferente. Esto se puede hacer proporcionando una ruta diferente para el nuevo nombre del archivo.
Ejemplo 2: función de cambio de nombre () para mover un archivo
#include #include using namespace std; int main() ( char oldname() = "C:\Users\file_old.txt"; char newname() = "C:\Users\New Folder\file_new.txt"; /* Deletes the file if exists */ if (rename(oldname, newname) != 0) perror("Error moving file"); else cout << "File moved successfully"; return 0; )
Cuando ejecute el programa, la salida será:
- Si el archivo se mueve correctamente:
Archivo movido exitosamente
- Si el archivo no está presente:
Error al mover el archivo: no existe tal archivo o directorio