copy
Начиная с Kotlin: 1.5
inline fun Path.copyTo(target: Path, overwrite: Boolean = false): Path
Копирует файл или каталог, указанный этим путём, по заданному пути назначения.
В отличие от File.copyTo, если какие-либо каталоги на пути к назначению отсутствуют, они не будут созданы автоматически. Чтобы убедиться, что необходимые промежуточные каталоги созданы, можно использовать функцию createParentDirectories:
sourcePath.copyTo(destinationPath.createParentDirectories())Если путь назначения уже существует, эта функция завершится ошибкой, если аргумент overwrite не установлен в true.
Если overwrite равен true и назначение является каталогом, он заменяется только в том случае, если он пуст.
Если этот путь указывает на каталог, он копируется без содержимого, то есть создаётся пустой каталог назначения. Чтобы скопировать каталог вместе с его содержимым, используйте copyToRecursively.
Операция не сохраняет атрибуты скопированных файлов, например дату создания или изменения, разрешения и т. д.
Результат
путь назначения.
Параметры
true, если разрешена перезапись назначения.
См. также
Выбрасывает
если исходный путь не существует.
если путь назначения уже существует, а аргумент overwrite установлен в false.
если путь назначения указывает на существующий каталог, аргумент overwrite равен true, а заменяемый каталог не пуст.
если при копировании возникнут ошибки.
inline fun Path.copyTo(target: Path, vararg options: CopyOption): Path
Копирует файл или каталог, указанный этим путём, по заданному пути назначения.
В отличие от File.copyTo, если какие-либо каталоги на пути к назначению отсутствуют, они не будут созданы автоматически. Чтобы убедиться, что необходимые промежуточные каталоги созданы, можно использовать функцию createParentDirectories:
sourcePath.copyTo(destinationPath.createParentDirectories())Если путь назначения уже существует, эта функция завершится ошибкой, если не используется параметр REPLACE_EXISTING.
Если используется REPLACE_EXISTING и назначение является каталогом, он заменяется только в том случае, если он пуст.
Если этот путь указывает на каталог, он копируется без содержимого, то есть создаётся пустой каталог назначения. Чтобы скопировать каталог вместе с его содержимым, используйте copyToRecursively.
Операция не сохраняет атрибуты скопированных файлов, например дату создания или изменения, разрешения и т. д., если не используется COPY_ATTRIBUTES.
Результат
путь назначения.
Параметры
параметры, определяющие способ копирования пути.
См. также
Выбрасывает
если исходный путь не существует.
если путь назначения уже существует и параметр REPLACE_EXISTING не используется.
если путь назначения указывает на существующий каталог, используется REPLACE_EXISTING, а заменяемый каталог не пуст.
если при копировании возникнут ошибки.
© 2010–2026 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.io.path/copy-to.html
