CKTIS / C++
std::filesystem::copy: kopírovanie objektov súborového systému
std::filesystem::copy kopíruje súbor, symbolický odkaz alebo adresár podľa typu zdroja a bitov copy_options a hlási chyby výnimkou či error_code.
Verzia: C++23
Syntax
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> vracia void. Predvolené copy_options::none kopíruje obsah bežných súborov, nasleduje symbolické odkazy a pri adresári kopíruje bezprostredné súbory, nie však vnorené podadresáre; copy_options::recursive zapne úplný zostup.
Príklad vytvorí zdrojový adresár s a.txt, zavolá copy s recursive, prečíta kópiu a vypíše 1 data. Ide o skutočnú operáciu súborového systému, preto kód pred použitím aj po ňom odstráni svoj súkromný testovací adresár.
Z každej skupiny volieb — existujúci cieľ, rekurzia, odkazy a forma kópie — smie byť nastavený najviac jeden bit; porušenie predpokladu vedie k nedefinovanému správaniu. skip_existing, overwrite_existing a update_existing zaobchádzajú s cieľom rôzne, copy_symlinks a skip_symlinks menia odkazy. Pri create_symlinks musí byť from absolútna, ibaže to leží v aktuálnom adresári. Ak je equivalent(from, to) true, funkcia hlási chybu; nejde o nedefinované správanie z predpokladu volieb. Preťaženia bez error_code môžu vyhodiť filesystem_error; forma s ec hlási systémové chyby cezň.
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-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ýsledok
1 data
std::filesystem::copy → 1 data