Расширения для java.io.File

Добавляет массив байтов к содержимому этого файла.

fun File.appendBytes(array: ByteArray)

Добавляет текст к содержимому этого файла, используя UTF-8 или указанный кодировку.

fun File.appendText(
    text: String, 
    charset: Charset = Charsets.UTF_8)

Возвращает новый BufferedReader для чтения содержимого этого файла.

fun File.bufferedReader(
    charset: Charset = Charsets.UTF_8, 
    bufferSize: Int = DEFAULT_BUFFER_SIZE
): BufferedReader

Возвращает новый BufferedWriter для записи содержимого этого файла.

fun File.bufferedWriter(
    charset: Charset = Charsets.UTF_8, 
    bufferSize: Int = DEFAULT_BUFFER_SIZE
): BufferedWriter

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

fun File.copyRecursively(
    target: File, 
    overwrite: Boolean = false, 
    onError: (File, IOException) -> OnErrorAction = { _, exception -> throw exception }
): Boolean

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

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

Удаляет этот файл и все его подкаталоги. Обратите внимание, что в случае неудачи может произойти частичное удаление.

fun File.deleteRecursively(): Boolean

Определяет, заканчивается ли путь этого файла путем файла other.

fun File.endsWith(other: File): Boolean

Определяет, принадлежит ли этот файл к той же корневой директории, что и other, и заканчивается ли он всеми компонентами other в том же порядке. Так, если other содержит N компонентов, последние N компонентов this должны быть такими же, как в other. Для относительного other, this может принадлежать любой корневой директории.

fun File.endsWith(other: String): Boolean

Возвращает расширение этого файла (без точки), или пустую строку, если его нет.

val File.extension: String

Читает файл блоками байтов и вызывает action для каждого прочитанного блока. Размер блока по умолчанию зависит от реализации. Эта функция передает массив байтов и количество байтов в массиве функции action.

fun File.forEachBlock(
    action: (buffer: ByteArray, bytesRead: Int) -> Unit)

Читает файл блоками байтов и вызывает action для каждого прочитанного блока. Эта функция передает массив байтов и количество байтов в массиве функции action.

fun File.forEachBlock(
    blockSize: Int, 
    action: (buffer: ByteArray, bytesRead: Int) -> Unit)

Читает этот файл построчно, используя указанную кодировку, и вызывает action для каждой строки. Кодировка по умолчанию - UTF-8.

fun File.forEachLine(
    charset: Charset = Charsets.UTF_8, 
    action: (line: String) -> Unit)

Создаёт новый FileInputStream для этого файла и возвращает его.

fun File.inputStream(): FileInputStream

Возвращает путь этого файла, используя неизменный разделитель '/' для разделения имён в последовательности имён.

val File.invariantSeparatorsPath: String

Определяет, имеет ли этот файл корень или представляет собой относительный путь.

val File.isRooted: Boolean

Возвращает имя файла без расширения.

val File.nameWithoutExtension: String

Удаляет все точки и разрешает все возможные .. в имени файла. Например, File("/foo/./bar/gav/../baaz").normalize() равно File("/foo/bar/baaz").

fun File.normalize(): File

Создаёт новый FileOutputStream для этого файла и возвращает его.

fun File.outputStream(): FileOutputStream

Возвращает новый PrintWriter для записи содержимого этого файла.

fun File.printWriter(
    charset: Charset = Charsets.UTF_8
): PrintWriter

Возвращает всё содержимое файла в виде массива байтов.

fun File.readBytes(): ByteArray

Возвращает новый FileReader для чтения содержимого этого файла.

fun File.reader(
    charset: Charset = Charsets.UTF_8
): InputStreamReader

Читает содержимое файла как список строк.

fun File.readLines(
    charset: Charset = Charsets.UTF_8
): List<String>

Получает всё содержимое этого файла как строку, используя UTF-8 или указанную charset.

fun File.readText(charset: Charset = Charsets.UTF_8): String

Вычисляет относительный путь для этого файла из файла base. Обратите внимание, что файл base рассматривается как директория. Если этот файл совпадает с файлом base, то будет возвращен File с пустым путем.

fun File.relativeTo(base: File): File

Вычисляет относительный путь для этого файла из файла base. Обратите внимание, что файл base рассматривается как директория. Если этот файл совпадает с файлом base, то будет возвращен File с пустым путем.

fun File.relativeToOrNull(base: File): File?

Вычисляет относительный путь для этого файла из файла base. Обратите внимание, что файл base рассматривается как директория. Если этот файл совпадает с файлом base, то будет возвращен File с пустым путем.

fun File.relativeToOrSelf(base: File): File

Добавляет файл relative к этому, рассматривая это как директорию. Если relative имеет корень, возвращается relative. Например, File("/foo/bar").resolve(File("gav")) это File("/foo/bar/gav"). Эта функция дополняет relativeTo, поэтому f.resolve(g.relativeTo(f)) == g всегда должен быть true за исключением случая с разными корнями.

fun File.resolve(relative: File): File

Добавляет имя relative к этому, рассматривая это как директорию. Если relative имеет корень, возвращается relative. Например, File("/foo/bar").resolve("gav") это File("/foo/bar/gav").

fun File.resolve(relative: String): File

Добавляет файл relative к родительской директории. Если relative имеет корень или у этого нет родительской директории, возвращается relative. Например, File("/foo/bar").resolveSibling(File("gav")) это File("/foo/gav").

fun File.resolveSibling(relative: File): File

Добавляет имя relative к родительской директории. Если relative имеет корень или у этого нет родительской директории, возвращается relative. Например, File("/foo/bar").resolveSibling("gav") это File("/foo/gav").

fun File.resolveSibling(relative: String): File

Определяет, принадлежит ли этот файл к тому же корню, что и other, и начинается ли он со всех компонентов other в том же порядке. Таким образом, если other имеет N компонентов, первые N компонентов this должны быть такими же, как в other.

fun File.startsWith(other: File): Boolean

fun File.startsWith(other: String): Boolean

Вычисляет относительный путь для этого файла из файла base. Обратите внимание, что файл base рассматривается как директория. Если этот файл совпадает с файлом base, то будет возвращена пустая строка.

fun File.toRelativeString(base: File): String

Вызывает обратный вызов block, передавая ему последовательность всех строк в этом файле, и закрывает считывающее устройство после завершения обработки.

fun <T> File.useLines(
    charset: Charset = Charsets.UTF_8, 
    block: (Sequence<String>) -> T
): T

Получает последовательность для посещения этого каталога и всего его содержимого.

fun File.walk(
    direction: FileWalkDirection = FileWalkDirection.TOP_DOWN
): FileTreeWalk

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

fun File.walkBottomUp(): FileTreeWalk

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

fun File.walkTopDown(): FileTreeWalk

Устанавливает содержимое этого файла как array байтов. Если этот файл уже существует, он будет перезаписан.

fun File.writeBytes(array: ByteArray)

Возвращает новый FileWriter для записи содержимого этого файла.

fun File.writer(
    charset: Charset = Charsets.UTF_8
): OutputStreamWriter

Устанавливает содержимое этого файла как текст, закодированный с использованием UTF-8 или указанного кодировки. Если файл существует, он перезаписывается.

fun File.writeText(
    text: String, 
    charset: Charset = Charsets.UTF_8)