CKTIS / C++
std::filesystem::rename : changer le nom ou l’emplacement
std::filesystem::rename déplace une entrée de old_p vers new_p selon la sémantique de rename POSIX, sans copier son contenu.
Version : C++23
Syntaxe
void std::filesystem::rename(
const std::filesystem::path& old_p,
const std::filesystem::path& new_p);
void std::filesystem::rename(
const std::filesystem::path& old_p,
const std::filesystem::path& new_p, std::error_code& ec) noexcept;std::filesystem::rename(old_p, new_p) de <filesystem> change le nom ou l’emplacement d’un objet et renvoie void. Si les deux chemins désignent le même fichier existant, elle ne fait rien ; un lien symbolique est déplacé lui-même, sans suivre sa cible.
L’exemple crée old.txt, le renomme en new.txt, vérifie les deux chemins et lit le contenu. 1 1 data confirme l’absence de l’ancien nom, la présence du nouveau et la conservation des données.
Un fichier cible existant qui n’est pas un répertoire peut être remplacé. Remplacer un répertoire vide fonctionne sur POSIX mais peut échouer ailleurs ; un déplacement entre systèmes de fichiers peut aussi échouer. La forme lançante signale filesystem_error, la forme error_code& est noexcept et fixe ec.
Exemples
#include <filesystem>
#include <fstream>
#include <iostream>
#include <string>
int main() {
namespace fs = std::filesystem;
const fs::path root = fs::temp_directory_path() / "cktis-cpp-ref-rename";
const fs::path old_path = root / "old.txt";
const fs::path new_path = root / "new.txt";
std::error_code ignored;
fs::remove_all(root, ignored);
fs::create_directory(root);
std::ofstream(old_path) << "data";
fs::rename(old_path, new_path);
std::ifstream input(new_path);
std::string text;
input >> text;
input.close();
std::cout << !fs::exists(old_path) << ' ' << fs::exists(new_path) << ' ' << text << '\n';
fs::remove_all(root, ignored);
}
Résultat
1 1 data
std::filesystem::rename → 1 1 data