std:: rename
| I/O manipulators | ||||
| Print functions (C++23) | ||||
| C-style I/O | ||||
| Buffers | ||||
|
(C++23)
|
||||
|
(
C++98/26*
)
|
||||
|
(C++20)
|
||||
| Streams | ||||
| Abstractions | ||||
| File I/O | ||||
| String I/O | ||||
| Array I/O | ||||
|
(C++23)
|
||||
|
(C++23)
|
||||
|
(C++23)
|
||||
|
(
C++98/26*
)
|
||||
|
(
C++98/26*
)
|
||||
|
(
C++98/26*
)
|
||||
| Synchronized Output | ||||
|
(C++20)
|
||||
| Types | ||||
| Error category interface | ||||
|
(C++11)
|
||||
|
(C++11)
|
| Types and objects | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Functions | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
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
|
|