Spec-Zone.ru › Kotlin 2

copyTo

kotlin-stdlib/kotlin.io/copyTo

Начиная с Kotlin: 1.0

@IgnorableReturnValue
fun InputStream.copyTo(out: OutputStream, bufferSize: Int = DEFAULT_BUFFER_SIZE): Long

Копирует этот поток в указанный выходной поток и возвращает количество скопированных байтов

Примечание Закрыть оба этих ресурса должен вызывающий код.


@IgnorableReturnValue
fun Reader.copyTo(out: Writer, bufferSize: Int = DEFAULT_BUFFER_SIZE): Long

Копирует этот reader в указанный out writer и возвращает количество скопированных символов.

Примечание Закрыть оба этих ресурса должен вызывающий код.

Возвращает

количество скопированных символов.

Параметры

out

writer, в который выполняется запись.

bufferSize

размер буфера символов, используемого в процессе.


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

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

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

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

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

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

Возвращает

файл target.

Параметры

overwrite

true если перезапись назначения разрешена.

bufferSize

размер буфера, используемого при копировании.

Исключения

NoSuchFileException

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

FileAlreadyExistsException

если файл назначения уже существует, а аргумент overwrite установлен в false.

IOException

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

© 2010–2026 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.io/copy-to.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API