std::experimental::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. Des 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. Des 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 : aucune action n'est effectuée dans ce cas.
• répertoire existant : new_p est supprimé s'il est vide sur les systèmes POSIX, mais cela peut constituer 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 dot ou par dot-dot .
• 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

, $tags.Don\text{'}t\; translate\; C++\; specific\; terms.\; Requires\; precision\; and\; professionalism."\; qui\; a\; été\; traduit\; en\; instructions\; en\; français.\; Le\; contenu\; HTML\; fourni\; ne\; contenait\; aucun\; texte\; à\; traduire\; hormis\; les\; termes\; C++\; (std::bad\_alloc)\; qui\; doivent\; rester\; en\; anglais\; selon\; les\; consignes.*$

Exemple

#include <experimental/filesystem>
#include <fstream>
#include <iostream>
namespace fs = std::experimental::filesystem;
int main()
{
    fs::path p = fs::current_path() / "sandbox";
    fs::create_directories(p/"from");
    std::ofstream(p/"from/file1.txt").put('a');
    fs::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
    fs::remove_all(p);
}

Voir aussi