Namespaces
Variants

std:: rename

From cppreference.net
< cpp ‎ | io ‎ | c
C++
Input/output library
C-style I/O
Défini dans l'en-tête <cstdio>
int rename ( const char * old_filename, const char * new_filename ) ;

Modifie le nom de fichier d'un fichier. Le fichier est identifié par la chaîne de caractères pointée par old_filename . Le nouveau nom de fichier est identifié par la chaîne de caractères pointée par new_filename .

Si new_filename existe, le comportement est défini par l'implémentation.

Table des matières

Paramètres

old_filename - pointeur vers une chaîne de caractères terminée par un caractère nul contenant le chemin identifiant le fichier à renommer
new_filename - pointeur vers une chaîne de caractères terminée par un caractère nul contenant le nouveau chemin du fichier

Valeur de retour

​ 0 ​ en cas de succès ou une valeur non nulle en cas d'erreur.

Notes

POSIX spécifie de nombreux détails supplémentaires sur la sémantique de cette fonction, qui sont reproduits en C++ par std::filesystem::rename .

Exemple

Exécuter ce code 
#include <cstdio>
#include <cstdlib>
#include <fstream>
#include <iostream>
int main()
{
    if (!std::ofstream("from.txt").put('a')) // créer et écrire dans le fichier
    {
        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'; // afficher le fichier
    return EXIT_SUCCESS;
}

Sortie : 

a

Voir aussi

(C++17)
déplace ou renomme un fichier ou un répertoire
(fonction)
supprime un fichier
(fonction)
Documentation C pour rename