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

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

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

Параметры

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

Исключения

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

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

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

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

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

См. также

Files.copy