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, если в options присутствует copy_options::skip_symlinks, copy_options::copy_symlinks или copy_options::create_symlinks;
• std::filesystem::status в противном случае.
• При необходимости получает состояние to не более чем одним вызовом
• std::filesystem::symlink_status, если в options присутствует copy_options::skip_symlinks или copy_options::create_symlinks;
• std::filesystem::status в противном случае (в том числе если в options присутствует copy_options::copy_symlinks).
• Если from или to имеет тип файла, определяемый реализацией, то поведение этой функции определяется реализацией.
• Если from не существует, сообщает об ошибке.
• Если from и to являются одним и тем же файлом согласно std::filesystem::equivalent, сообщает об ошибке.
• Если from или to не является обычным файлом, каталогом или символической ссылкой согласно std::filesystem::is_other, сообщает об ошибке.
• Если from является каталогом, а to — обычным файлом, сообщает об ошибке.
• Если from является символической ссылкой, то
• Если в options присутствует copy_options::skip_symlink, ничего не делает.
• В противном случае, если to не существует и в options присутствует copy_options::copy_symlinks, действует так, как если бы было выполнено copy_symlink(from, to).
• В противном случае сообщает об ошибке.
• В противном случае, если from является обычным файлом, то
• Если в options присутствует copy_options::directories_only, ничего не делает.
• В противном случае, если в options присутствует copy_options::create_symlinks, создает символическую ссылку на to. Примечание: from должен быть абсолютным путем, если только to не находится в текущем каталоге.
• В противном случае, если в options присутствует copy_options::create_hard_links, создает жесткую ссылку на to.
• В противном случае, если to является каталогом, действует так, как если бы было выполнено copy_file(from, to/from.filename(), options) (создает копию from как файл в каталоге to).
• В противном случае действует так, как если бы было выполнено copy_file(from, to, options) (копирует файл).
• В противном случае, если from является каталогом и в options установлен copy_options::create_symlinks, сообщает об ошибке с кодом ошибки 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++.

См. также