CKTIS / C++
std::filesystem::copy: копиране на обекти от файловата система
std::filesystem::copy копира файл, символна връзка или директория според типа на източника и битовете copy_options и съобщава грешки чрез изключение или error_code.
Версия: C++23
Синтаксис
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) от <filesystem> връща void. Подразбиращото се copy_options::none копира съдържанието на обикновени файлове, следва символни връзки и при директория копира непосредствените файлове, но не вложените поддиректории; copy_options::recursive включва пълно слизане.
Примерът създава изходна директория с a.txt, извиква copy с recursive, прочита копието и извежда 1 data. Това е истинска операция на файловата система, затова кодът премахва собствената си тестова директория преди и след употреба.
От всяка група опции — съществуваща цел, рекурсия, връзки и форма на копиране — може да е зададен най-много един бит; нарушаването на предусловието води до неопределено поведение. skip_existing, overwrite_existing и update_existing третират целта различно, а copy_symlinks и skip_symlinks променят връзките. При create_symlinks пътят from трябва да е абсолютен, освен ако to е в текущата директория. Ако equivalent(from, to) е true, функцията съобщава грешка; това не е неопределеното поведение от предусловието за опциите. Претоварванията без error_code могат да хвърлят filesystem_error; формата с ec съобщава файловите грешки чрез него.
Примери
#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);
}
Резултат
1 data
std::filesystem::copy → 1 data