База знанияИзпитен център
BGБългарски
Избери език13

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

Източници