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.