CKTIS / C++
std::filesystem::rename: Name oder Ort ändern
std::filesystem::rename verschiebt einen Eintrag von old_p nach new_p gemäß POSIX-rename-Semantik, ohne seinen Inhalt zu kopieren.
Version: C++23
Syntax
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) aus <filesystem> ändert Name oder Ort eines Dateisystemobjekts und liefert void. Bezeichnen beide Pfade dieselbe vorhandene Datei, geschieht nichts; ein Symlink wird als Eintrag verschoben, nicht sein Ziel.
Das Beispiel erstellt old.txt, benennt in new.txt um, prüft beide Pfade und liest den Inhalt. 1 1 data bestätigt die Abwesenheit des alten Namens, die Existenz des neuen und unveränderte Daten.
Eine vorhandene Zieldatei, die kein Verzeichnis ist, kann ersetzt werden. Ein leeres Zielverzeichnis wird auf POSIX ersetzt, kann auf anderen Systemen aber einen Fehler geben; auch ein Wechsel zwischen Dateisystemen kann scheitern. Die werfende Form meldet filesystem_error, die error_code&-Form ist noexcept und setzt ec.
Beispiele
#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);
}
Ergebnis
1 1 data
std::filesystem::rename → 1 1 data