std::filesystem:: rename

Déplace ou renomme l'objet du système de fichiers identifié par old_p vers new_p comme le ferait la fonction POSIX rename :

• Si old_p est un fichier non-répertoire, alors new_p doit être l'un des éléments suivants :

• le même fichier que old_p ou un lien physique vers celui-ci : aucune action n'est effectuée dans ce cas.
• fichier non-répertoire existant : new_p est d'abord supprimé, puis, sans permettre à d'autres processus d'observer new_p comme étant supprimé, le chemin new_p est lié au fichier et old_p est délié du fichier. Les permissions d'écriture sont requises à la fois pour le répertoire contenant old_p et le répertoire contenant new_p .
• fichier inexistant dans un répertoire existant : Le chemin new_p est lié au fichier et old_p est délié du fichier. Les permissions d'écriture sont requises à la fois pour le répertoire contenant old_p et le répertoire contenant new_p .

• Si old_p est un répertoire, alors new_p doit être l'un des éléments suivants :

• le même répertoire que old_p ou un lien physique vers celui-ci : rien n'est fait dans ce cas.
• répertoire existant : new_p est supprimé s'il est vide sur les systèmes POSIX, mais cela peut être une erreur sur d'autres systèmes. Si ce n'est pas une erreur, alors new_p est d'abord supprimé, puis, sans permettre à d'autres processus d'observer new_p comme supprimé, le chemin new_p est lié au répertoire et old_p est délié du répertoire. Les permissions d'écriture sont requises à la fois pour le répertoire contenant old_p et le répertoire contenant new_p .
• répertoire inexistant, ne se terminant pas par un séparateur de répertoire, et dont le répertoire parent existe : Le chemin new_p est lié au répertoire et old_p est délié du répertoire. Les permissions d'écriture sont requises à la fois pour le répertoire contenant old_p et le répertoire contenant new_p .

• Les liens symboliques ne sont pas suivis : si old_p est un lien symbolique, c'est lui-même qui est renommé, pas sa cible. Si new_p est un lien symbolique existant, c'est lui-même qui est effacé, pas sa cible.

La renommation échoue si

• new_p se termine par point ou par point-point .
• new_p désigne un répertoire inexistant se terminant par un séparateur de répertoire.
• old_p est un répertoire qui est un ancêtre de new_p .

Paramètres

Valeur de retour

(aucun)

Exceptions

Toute surcharge non marquée noexcept peut lever std::bad_alloc si l'allocation de mémoire échoue.

Exemple

#include <filesystem>
#include <fstream>
namespace fs = std::filesystem;
int main()
{
    std::filesystem::path p = std::filesystem::current_path() / "sandbox";
    std::filesystem::create_directories(p / "from");
    std::ofstream{ p / "from/file1.txt" }.put('a');
    std::filesystem::create_directory(p / "to");
//  fs::rename(p / "from/file1.txt", p / "to/"); // error: "to" is a directory
    fs::rename(p / "from/file1.txt", p / "to/file2.txt"); // OK
//  fs::rename(p / "from", p / "to"); // error: "to" is not empty
    fs::rename(p / "from", p / "to/subdir"); // OK
    std::filesystem::remove_all(p);
}

Voir aussi