Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

std::filesystem::rename: zmena názvu alebo umiestnenia

std::filesystem::rename presunie položku z old_p do new_p podľa sémantiky POSIX rename bez kopírovania obsahu.

Verzia: 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) z <filesystem> zmení názov alebo umiestnenie objektu a vracia void. Ak obe cesty označujú rovnaký existujúci súbor, nič neurobí; symbolický odkaz presunie ako položku a nenasleduje jeho cieľ.

Príklad vytvorí old.txt, premenuje ho na new.txt, overí obe cesty a prečíta obsah. 1 1 data potvrdzuje neprítomnosť starého názvu, existenciu nového a zachovanie dát.

Existujúci cieľový súbor, ktorý nie je adresárom, možno nahradiť. Nahradenie prázdneho adresára funguje na POSIX, inde však môže byť chybou; zlyhať môže aj presun medzi súborovými systémami. Vyhadzujúca forma hlási filesystem_error; forma error_code& je noexcept a nastaví ec.

Príklady

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

Výsledok

1 1 data

std::filesystem::rename → 1 1 data

Zdroje