CKTIS / C++
std::filesystem::copy: kopiranje objekata datotečnog sustava
std::filesystem::copy kopira datoteku, simboličku poveznicu ili direktorij prema vrsti izvora i bitovima copy_options te prijavljuje pogreške iznimkom ili error_code.
Verzija: C++23
Sintaksa
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) iz <filesystem> vraća void. Zadani copy_options::none kopira sadržaj običnih datoteka, slijedi simboličke poveznice i za direktorij kopira neposredne datoteke, ali ne ugniježđene poddirektorije; copy_options::recursive uključuje potpuni silazak.
Primjer stvara izvorni direktorij s a.txt, poziva copy s recursive, čita kopiju i ispisuje 1 data. To je stvarna operacija datotečnog sustava pa kod uklanja svoj privatni testni direktorij prije i poslije uporabe.
Iz svake skupine opcija — postojeći cilj, rekurzija, poveznice i oblik kopije — smije biti postavljen najviše jedan bit; kršenje preduvjeta daje nedefinirano ponašanje. skip_existing, overwrite_existing i update_existing različito obrađuju cilj, a copy_symlinks i skip_symlinks poveznice. Uz create_symlinks, from mora biti apsolutna putanja, osim ako je to u trenutačnom direktoriju. Ako je equivalent(from, to) true, funkcija prijavljuje pogrešku; to nije nedefinirano ponašanje iz preduvjeta opcija. Preopterećenja bez error_code mogu baciti filesystem_error; oblik s ec kroz njega prijavljuje sistemske pogreške.
Primjeri
#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);
}
Rezultat
1 data
std::filesystem::copy → 1 data