Spec-Zone.ru › Kotlin 1.6

createTempFile

kotlin-stdlib / kotlin.io / createTempFile
Требования к платформе и версии: JVM (1.0)
fun createTempFile(
    prefix: String = "tmp", 
    suffix: String? = null, 
    directory: File? = null
): File
Устарело: Избегайте создания временных файлов в стандартном каталоге временных файлов с помощью этой функции из-за слишком широких разрешений на вновь созданный файл. Используйте kotlin.io.path.createTempFile вместо этого или обратитесь к java.io.File.createTempFile.

Создаёт новый пустой файл в указанном каталоге, используя заданный префикс и суффикс для генерации его имени.

Если префикс не указан, будет использоваться некий неопределённый строковый префикс. Если суффикс не указан, будет использоваться ".tmp". Если каталог не указан, будет использован стандартный каталог временных файлов.

Аргумент префикс, если указан, должен иметь длину не менее трёх символов. Рекомендуется, чтобы префикс был короткой, осмысленной строкой, например, «job» или «mail».

Для создания нового файла префикс и суффикс могут быть предварительно изменены для соответствия ограничениям платформы.

Примечание: если новый файл создаётся в каталоге, доступном всем пользователям, ему могут быть предоставлены разрешения, позволяющие всем его читать, что создаёт риск раскрытия конфиденциальной информации, хранящейся в этом файле. Чтобы избежать этого, рекомендуется указать явный родительский каталог, который не широко доступен, или использовать альтернативные способы создания временных файлов, такие как java.nio.file.Files.createTempFile или экспериментальная createTempFile функция в kotlin.io.path пакете.

Исключения

IOException - в случае ошибки ввода-вывода.

IllegalArgumentException - если префикс короче трёх символов.

Возвращает объект файла, соответствующий вновь созданному файлу.

© 2010–2022 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.io/create-temp-file.html

Spec-Zone.ru

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