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 и целевой путь является директорией, она заменяется только если пуста.

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

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

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

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

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

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

Параметры

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

Исключения

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

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

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

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

Возвращает целевой путь.

См. также

Files.copy