30 Input/output library [input.output]

30.10 File systems [filesystems]

30.10.34 Filesystem operation functions [fs.op.funcs]

30.10.34.4 Copy file [fs.op.copy_file]

bool copy_file(const path& from, const path& to); bool copy_file(const path& from, const path& to, error_code& ec) noexcept;

Returns: copy_file(from, to, copy_options::none) или
copy_file(from, to, copy_options::none, ec), соответственно.

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

bool copy_file(const path& from, const path& to, copy_options options); bool copy_file(const path& from, const path& to, copy_options options, error_code& ec) noexcept;

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

Effects: Следующее:

(4.1)
Сообщить об ошибке, что файл уже существует, [fs.err.report] если:
- (4.1.1)
  !is_regular_file(from), или
- (4.1.2)
  exists(to) и !is_regular_file(to), или
- (4.1.3)
  exists(to) и equivalent(from, to), или
- (4.1.4)
  exists(to) а также
```
(options & (copy_options::skip_existing |
            copy_options::overwrite_existing |
            copy_options::update_existing)) == copy_options::none
```
(4.2)
В противном случае скопируйте содержимое и атрибуты файла, в который from разрешается, в файл, в который to разрешается, если:
- (4.2.1)
  !exists(to), или
- (4.2.2)
  (options & copy_options::overwrite_existing) != copy_options::none, или
- (4.2.3)
  (options & copy_options::update_existing) != copy_options::none и from является более поздним, чем toопределяется, как если бы с использованием last_write_time функции ([fs.op.last_write_time]).
(4.3)
В остальном никаких эффектов.

Returns: true если from файл был скопирован, иначе false. Подпись с аргументом ec возвращается, false если возникает ошибка.

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

Complexity: Максимум один прямой или косвенный вызов status(to).