Namespaces
Variants

std:: rename

From cppreference.net
< cpp ‎ | io ‎ | c
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)