std::filesystem::copy

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

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

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

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

Копирует файлы и каталоги с различными опциями.

Поведение следующее:

• Сначала, до выполнения любых других действий, получает тип и разрешения from не более чем за один вызов
• std::filesystem::symlink_status, если copy_options::skip_symlinks, copy_options::copy_symlinks, или copy_options::create_symlinks присутствуют в options;
• std::filesystem::status в противном случае.
• При необходимости, получает состояние to, не более чем за один вызов
• std::filesystem::symlink_status, если copy_options::skip_symlinks или copy_options::create_symlinks присутствуют в options;
• std::filesystem::status в противном случае (включая случай, когда copy_options::copy_symlinks присутствует в options).
• Если у from или to есть реализационно-зависимый тип файла, то поведение этой функции реализационно-зависимо.
• Если from не существует, выдаёт ошибку.
• Если from и to являются одним и тем же файлом, как определено std::filesystem::equivalent, выдаёт ошибку.
• Если from или to не являются обычным файлом, каталогом или символьным ссылкой, как определено std::filesystem::is_other, выдаёт ошибку.
• Если from является каталогом, а to — обычным файлом, выдаёт ошибку.
• Если from является символьной ссылкой, то
• Если copy_options::skip_symlink присутствует в options, ничего не делает.
• В противном случае, если to не существует и copy_options::copy_symlinks присутствует в options, ведет себя так, как если бы copy_symlink(from, to).
• В противном случае, выдаёт ошибку.
• В противном случае, если from является обычным файлом, то
• Если copy_options::directories_only присутствует в options, ничего не делает.
• В противном случае, если copy_options::create_symlinks присутствует в options, создаёт символическую ссылку на to. Примечание: from должна быть абсолютным путём, если to не находится в текущем каталоге.
• В противном случае, если copy_options::create_hard_links присутствует в options, создаёт жёсткую ссылку на to.
• В противном случае, если to является каталогом, ведет себя как copy_file(from, to/from.filename(), options) (создаёт копию from как файл в каталоге to).
• В противном случае, ведет себя как copy_file(from, to, options) (копирует файл).
• В противном случае, если from является каталогом и copy_options::create_symlinks задано в options, выдаёт ошибку с кодом ошибки, равным std::make_error_code(std::errc::is_a_directory).
• В противном случае, если from является каталогом и options имеет copy_options::recursive или является copy_options::none,
• Если to не существует, сначала выполняет create_directory(to, from) (создаёт новый каталог с копией атрибутов старого каталога).
• Затем, независимо от того, существовал ли to или только что был создан, перебирает файлы, содержащиеся в from так, как если бы это делалось функцией for (const std::filesystem::directory_entry& x : std::filesystem::directory_iterator(from)), и для каждой записи каталога рекурсивно вызывает copy(x.path(), to/x.path().filename(), options | in-recursive-copy), где in-recursive-copy — специальный бит, не имеющий другого эффекта при установке в options. (Единственная цель установки этого бита — предотвратить рекурсивное копирование подкаталогов, если options — copy_options::none.)
• В противном случае ничего не делает.

Параметры

Возвращаемое значение

(ничего)

Исключения

Любая перегрузка, не помеченная noexcept, может выбросить std::bad_alloc в случае неудачи выделения памяти.

Примечания

По умолчанию, при копировании каталогов выполняется нерекурсивное копирование: файлы копируются, но подкаталоги нет:

// Given
// /dir1 contains /dir1/file1, /dir1/file2, /dir1/dir2
// and /dir1/dir2 contains /dir1/dir2/file3
// After
std::filesystem::copy("/dir1", "/dir3");
// /dir3 is created (with the attributes of /dir1)
// /dir1/file1 is copied to /dir3/file1
// /dir1/file2 is copied to /dir3/file2

В то время как с copy_options::recursive, подкаталоги также копируются вместе с их содержимым рекурсивно.

// ...but after
std::filesystem::copy("/dir1", "/dir3", std::filesystem::copy_options::recursive);
// /dir3 is created (with the attributes of /dir1)
// /dir1/file1 is copied to /dir3/file1
// /dir1/file2 is copied to /dir3/file2
// /dir3/dir2 is created (with the attributes of /dir1/dir2)
// /dir1/dir2/file3 is copied to /dir3/dir2/file3

Пример

#include <cstdlib>
#include <filesystem>
#include <fstream>
#include <iostream>
namespace fs = std::filesystem;
 
int main()
{
    fs::create_directories("sandbox/dir/subdir");
    std::ofstream("sandbox/file1.txt").put('a');
    fs::copy("sandbox/file1.txt", "sandbox/file2.txt"); // copy file
    fs::copy("sandbox/dir", "sandbox/dir2"); // copy directory (non-recursive)
    const auto copyOptions = fs::copy_options::update_existing
                           | fs::copy_options::recursive
                           | fs::copy_options::directories_only
                           ;
    fs::copy("sandbox", "sandbox_copy", copyOptions); 
    static_cast<void>(std::system("tree"));
    fs::remove_all("sandbox");
    fs::remove_all("sandbox_copy");
}

.
├── sandbox
│   ├── dir
│   │   └── subdir
│   ├── dir2
│   ├── file1.txt
│   └── file2.txt
└── sandbox_copy
    ├── dir
    │   └── subdir
    └── dir2
 
8 directories, 2 files

Отчёты об ошибках

Следующие исправления, изменяющие поведение, были применены ретроактивно к ранее опубликованным стандартам C++.

См. также