std:: rename
|
Definido en el encabezado
<cstdio>
|
||
|
int
rename
(
const
char
*
old_filename,
const
char
*
new_filename
)
;
|
||
Cambia el nombre de archivo de un archivo. El archivo se identifica por la cadena de caracteres apuntada por old_filename . El nuevo nombre de archivo se identifica por la cadena de caracteres apuntada por new_filename .
Si new_filename existe, el comportamiento está definido por la implementación.
Contenidos |
Parámetros
| old_filename | - | puntero a una cadena terminada en nulo que contiene la ruta que identifica el archivo a renombrar |
| new_filename | - | puntero a una cadena terminada en nulo que contiene la nueva ruta del archivo |
Valor de retorno
0 en caso de éxito o valor distinto de cero en caso de error.
Notas
POSIX especifica muchos detalles adicionales sobre la semántica de esta función, que se reproducen en C++ mediante std::filesystem::rename .
Ejemplo
#include <cstdio> #include <cstdlib> #include <fstream> #include <iostream> int main() { if (!std::ofstream("from.txt").put('a')) // crear y escribir en el archivo { std::perror("Error creating from.txt"); return EXIT_FAILURE; } if (std::rename("from.txt", "to.txt")) { std::perror("Error renaming"); return EXIT_FAILURE; } std::cout << std::ifstream("to.txt").rdbuf() << '\n'; // imprimir archivo return EXIT_SUCCESS; }
Salida:
a
Véase también
|
(C++17)
|
mueve o renombra un archivo o directorio
(función) |
|
elimina un archivo
(función) |
|
|
Documentación de C
para
rename
|
|