copyTo

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

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

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

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

sourcePath.copyTo(destinationPath.apply { parent?.createDirectories() })

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

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

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

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

Параметры

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, если некоторые директории по пути к пути назначения отсутствуют, они не будут автоматически созданы. Вы можете использовать следующий подход для обеспечения создания необходимых промежуточных директорий:

sourcePath.copyTo(destinationPath.apply { parent?.createDirectories() })

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

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

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

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

Параметры

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

Исключения

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

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

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

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

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

См. также

Files.copy