copyTo

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

fun File.copyTo(
    target: File, 
    overwrite: Boolean = false, 
    bufferSize: Int = DEFAULT_BUFFER_SIZE
): File

Копирует этот файл в указанный файл target.

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

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

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

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

Параметры

overwrite - true разрешено ли перезаписывание назначения.

bufferSize - размер буфера для использования при копировании.

Исключения

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

FileAlreadyExistsException - если целевой файл уже существует и аргумент overwrite установлен в false.

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

Возвращаемое значение файл target.