30 Input/output library [input.output]

30.10 File systems [filesystems]

30.10.34 Filesystem operation functions [fs.op.funcs]

30.10.34.3 Copy [fs.op.copy]

void copy(const path& from, const path& to);

Effects: Эквивалентно copy(from, to, copy_options::none).

void copy(const path& from, const path& to, error_code& ec) noexcept;

Effects: Эквивалентно copy(from, to, copy_options::none, ec).

void copy(const path& from, const path& to, copy_options options); void copy(const path& from, const path& to, copy_options options, error_code& ec) noexcept;

Requires: [fs.enum.copy.opts]Устанавливается не более одного элемента из каждой группы опций ( ) options.

Effects: Перед первым применением f и t:

(4.1)

Если

(options & copy_options::create_symlinks) != copy_options::none ||
(options & copy_options::skip_symlinks) != copy_options::none

тогда auto f = symlink_status(from) и при необходимости auto t = symlink_status(to).

(4.2)
В противном случае, если
```
(options & copy_options::copy_symlinks) != copy_options::none
```
тогда auto f = symlink_status(from) и при необходимости auto t = status(to).
(4.3)
В противном случае auto f = status(from) и при необходимости auto t = status(to).

Эффекты тогда следующие:

(4.4)
Если f.type() или t.type() является типом файла, определяемым реализацией ([fs.enum.file_type]), то эффекты определяются реализацией.
(4.5)
В противном случае сообщается об ошибке, как указано в [fs.err.report] if:
- (4.5.1)
  !exists(f), или
- (4.5.2)
  equivalent(from, to), или
- (4.5.3)
  is_other(f) || is_other(t), или
- (4.5.4)
  is_directory(f) && is_regular_file(t).
(4.6)
В противном случае, если is_symlink(f), то:
- (4.6.1)
  Если (options & copy_options::skip_symlinks) != copy_options::none потом вернемся.
- (4.6.2)
  В противном случае, если
```
!exists(t) && (options & copy_options::copy_symlinks) != copy_options::none
```
  тогда copy_symlink(from, to).
- (4.6.3)
  В противном случае сообщите об ошибке, как указано в [fs.err.report].
(4.7)
В противном случае, если is_regular_file(f), то:
- (4.7.1)
  Если (options & copy_options::directories_only) != copy_options::none, то вернись.
- (4.7.2)
  В противном случае, если (options & copy_options::create_symlinks) != copy_options::none, то создайте символическую ссылку на исходный файл.
- (4.7.3)
  В противном случае, если (options & copy_options::create_hard_links) != copy_options::none, то создайте жесткую ссылку на исходный файл.
- (4.7.4)
  Иначе если is_directory(t), то copy_file(from, to/from.filename(), options).
- (4.7.5)
  В противном случае copy_file(from, to, options).

(4.8)

В противном случае, если

is_directory(f) &&
((options & copy_options::recursive) != copy_options::none ||
 options == copy_options::none)

тогда:

(4.8.1)
Если !exists(t), то create_directory(to, from).

(4.8.2)

Затем перейдите по файлам from, как если бы

for (const directory_entry& x : directory_iterator(from))
  copy(x.path(), to/x.path().filename(), options | copy_options::unspecified)

(4.9)
В противном случае, для подписи с аргументом ec, ec.clear().
(4.10)
В остальном никаких эффектов.

Throws: Как указано в [fs.err.report].

Remarks: Для подписи с аргументом ecлюбые библиотечные функции, вызываемые реализацией, должны иметь error_code аргумент, если это применимо.

[ Example: Учитывая эту структуру каталогов:

/dir1
  file1
  file2
  dir2
    file3

Вызов copy("/dir1", "/dir3") приведет к:

/dir1
  file1
  file2
  dir2
    file3
/dir3
  file1
  file2

В качестве альтернативы вызов copy("/dir1", "/dir3", copy_options::recursive) может привести к:

/dir1
  file1
  file2
  dir2
    file3
/dir3
  file1
  file2
  dir2
    file3

— end example ]