copyTo

Требования к платформе и версии: JVM (1.5), JRE7 (1.5)

fun Path.copyTo(
    target: Path, 
    overwrite: Boolean = false
): Path

Копирует файл или каталог, расположенный по этому пути, в указанный путь назначения.

В отличие от File.copyTo, если некоторые каталоги по пути к пути назначения отсутствуют, они не будут автоматически созданы. Вы можете использовать функцию createParentDirectories, чтобы убедиться, что необходимые промежуточные каталоги созданы:

sourcePath.copyTo(destinationPath.createParentDirectories())

Если путь назначения уже существует, эта функция завершится с ошибкой, если аргумент overwrite не установлен в true.

Когда overwrite равен true и путь назначения является каталогом, он заменяется только если пуст.

Если этот путь является каталогом, он копируется без своего содержимого, то есть создаётся пустой каталог назначения. Если вы хотите скопировать каталог, включая его содержимое, используйте copyToRecursively.

Операция не сохраняет атрибуты скопированного файла, такие как дата создания/изменения, разрешения и т. д.

Параметры

overwrite - true если разрешено перезаписывать целевой объект.

Исключения

NoSuchFileException - если исходный путь не существует.

FileAlreadyExistsException - если путь назначения уже существует и аргумент overwrite установлен в false.

DirectoryNotEmptyException - если путь назначения указывает на существующий каталог и аргумент overwrite равен true, когда заменяемый каталог не пуст.

IOException - если при копировании возникли какие-либо ошибки.

Возвращает путь назначения.

См. также

Files.copy

Требования к платформе и версии: JVM (1.5), JRE7 (1.5)

fun Path.copyTo(
    target: Path, 
    vararg options: CopyOption
): Path

Копирует файл или каталог, расположенный по этому пути, в указанный путь назначения.

В отличие от File.copyTo, если некоторые каталоги по пути к пути назначения отсутствуют, они не будут автоматически созданы. Вы можете использовать функцию createParentDirectories, чтобы убедиться, что необходимые промежуточные каталоги созданы:

sourcePath.copyTo(destinationPath.createParentDirectories())

Если путь назначения уже существует, эта функция завершится с ошибкой, если не используется опция REPLACE_EXISTING.

При использовании REPLACE_EXISTING и если путь назначения является каталогом, он заменяется только если пуст.

Если этот путь является каталогом, он копируется без своего содержимого, то есть создаётся пустой каталог назначения. Если вы хотите скопировать каталог, включая его содержимое, используйте copyToRecursively.

Операция не сохраняет атрибуты скопированного файла, такие как дата создания/изменения, разрешения и т. д., если не используется COPY_ATTRIBUTES.

Параметры

options - опции для управления тем, как копируется путь.

Исключения

NoSuchFileException - если исходный путь не существует.

FileAlreadyExistsException - если путь назначения уже существует и не используется REPLACE_EXISTING.

DirectoryNotEmptyException - если путь назначения указывает на существующий каталог и используется REPLACE_EXISTING, когда заменяемый каталог не пуст.

IOException - если при копировании возникли какие-либо ошибки.

Возвращает путь назначения.

См. также

Files.copy