std::filesystem:: copy

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

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

• Сначала, прежде чем делать что-либо еще, получает тип и разрешения 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 , если copy_options::skip_symlinks или copy_options::create_symlinks присутствует в options ;
• std::filesystem::status в противном случае (включая случай, когда copy_options::copy_symlinks присутствует в options ).

• Если либо from , либо to имеет определяемый реализацией file type , эффекты этой функции определяются реализацией.
• Если 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 при неудачном выделении памяти.

Примечания

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

// Дано
// /dir1 содержит /dir1/file1, /dir1/file2, /dir1/dir2
// и /dir1/dir2 содержит /dir1/dir2/file3
// После
std::filesystem::copy("/dir1", "/dir3");
// /dir3 создан (с атрибутами /dir1)
// /dir1/file1 скопирован в /dir3/file1
// /dir1/file2 скопирован в /dir3/file2

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

// ...но после
std::filesystem::copy("/dir1", "/dir3", std::filesystem::copy_options::recursive);
// /dir3 создается (с атрибутами /dir1)
// /dir1/file1 копируется в /dir3/file1
// /dir1/file2 копируется в /dir3/file2
// /dir3/dir2 создается (с атрибутами /dir1/dir2)
// /dir1/dir2/file3 копируется в /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"); // копирование файла
    fs::copy("sandbox/dir", "sandbox/dir2"); // копирование директории (нерекурсивное)
    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++.

Смотрите также