Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::filesystem::copy: kopírování objektů souborového systému

std::filesystem::copy kopíruje soubor, symbolický odkaz nebo adresář podle typu zdroje a bitů copy_options a hlásí chyby výjimkou či error_code.

Verze: C++23

Syntaxe

void std::filesystem::copy(
    const std::filesystem::path& from,
    const std::filesystem::path& to,
    std::filesystem::copy_options options);

void std::filesystem::copy(
    const std::filesystem::path& from,
    const std::filesystem::path& to,
    std::filesystem::copy_options options, std::error_code& ec);

std::filesystem::copy(from, to, options) z <filesystem> vrací void. Výchozí copy_options::none kopíruje obsah běžných souborů, následuje symbolické odkazy a u adresáře kopíruje bezprostřední soubory, ne však vnořené podadresáře; copy_options::recursive zapne úplný sestup.

Příklad vytvoří zdrojový adresář s a.txt, zavolá copy s recursive, přečte kopii a vypíše 1 data. Jde o skutečnou operaci souborového systému, proto kód před použitím i po něm odstraní svůj soukromý testovací adresář.

Z každé skupiny voleb — existující cíl, rekurze, odkazy a forma kopie — smí být nastaven nejvýše jeden bit; porušení předpokladu vede k nedefinovanému chování. skip_existing, overwrite_existing a update_existing zacházejí s cílem různě, copy_symlinks a skip_symlinks mění odkazy. Při create_symlinks musí být from absolutní, ledaže to leží v aktuálním adresáři. Je-li equivalent(from, to) true, funkce hlásí chybu; nejde o nedefinované chování z předpokladu voleb. Přetížení bez error_code mohou vyhodit filesystem_error; forma s ec hlásí systémové chyby přes něj.

Pří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-copy";
    const fs::path source = root / "source";
    const fs::path target = root / "target";
    std::error_code ignored;
    fs::remove_all(root, ignored);
    fs::create_directories(source);
    std::ofstream(source / "a.txt") << "data";

    fs::copy(source, target, fs::copy_options::recursive);
    std::ifstream input(target / "a.txt");
    std::string text;
    input >> text;
    std::cout << fs::exists(target / "a.txt") << ' ' << text << '\n';
    fs::remove_all(root, ignored);
}

Výsledek

1 data

std::filesystem::copy → 1 data

Zdroje