KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::filesystem::rename: naam of locatie wijzigen

std::filesystem::rename verplaatst een item van old_p naar new_p met POSIX-rename-semantiek en kopieert de inhoud niet.

Versie: 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) uit <filesystem> wijzigt naam of locatie van een object en retourneert void. Als beide paden naar hetzelfde bestaande bestand verwijzen, gebeurt niets; een symlink zelf wordt verplaatst zonder het doel te volgen.

Het voorbeeld maakt old.txt, hernoemt het naar new.txt, controleert beide paden en leest de inhoud. 1 1 data bevestigt dat de oude naam ontbreekt, de nieuwe bestaat en de gegevens behouden zijn.

Een bestaand doelbestand dat geen map is, kan worden vervangen. Een lege doelmap vervangen werkt op POSIX, maar kan elders een fout zijn; verplaatsen tussen bestandssystemen kan eveneens mislukken. De werpende vorm meldt filesystem_error; de error_code&-vorm is noexcept en zet ec.

Voorbeelden

#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);
}

Resultaat

1 1 data

std::filesystem::rename → 1 1 data

Bronnen