Расширения для java.nio.file.Path

Преобразует этот, возможно, относительный путь в абсолютный.

fun Path.absolute(): Path

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

fun Path.absolutePathString(): String

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

fun Path.appendBytes(array: ByteArray)

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

fun Path.appendLines(
    lines: Iterable<CharSequence>, 
    charset: Charset = Charsets.UTF_8
): Path

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

fun Path.appendLines(
    lines: Sequence<CharSequence>, 
    charset: Charset = Charsets.UTF_8
): Path

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

fun Path.appendText(
    text: CharSequence, 
    charset: Charset = Charsets.UTF_8)

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

fun Path.bufferedReader(
    charset: Charset = Charsets.UTF_8, 
    bufferSize: Int = DEFAULT_BUFFER_SIZE, 
    vararg options: OpenOption
): BufferedReader

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

fun Path.bufferedWriter(
    charset: Charset = Charsets.UTF_8, 
    bufferSize: Int = DEFAULT_BUFFER_SIZE, 
    vararg options: OpenOption
): BufferedWriter

Копирует файл или каталог, расположенный по этому пути, в указанный целевой путь.

fun Path.copyTo(
    target: Path, 
    overwrite: Boolean = false
): Path

fun Path.copyTo(
    target: Path, 
    vararg options: CopyOption
): Path

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

fun Path.copyToRecursively(
    target: Path, 
    onError: (source: Path, target: Path, exception: Exception) -> OnErrorResult = { _, _, exception -> throw exception }, 
    followLinks: Boolean, 
    overwrite: Boolean
): Path

fun Path.copyToRecursively(
    target: Path, 
    onError: (source: Path, target: Path, exception: Exception) -> OnErrorResult = { _, _, exception -> throw exception }, 
    followLinks: Boolean, 
    copyAction: CopyActionContext.(source: Path, target: Path) -> CopyActionResult = { src, dst ->
        src.copyToIgnoringExistingDirectory(dst, followLinks)
    }
): Path

Создает каталог, гарантируя, что все отсутствующие родительские каталоги существуют, создавая их предварительно.

fun Path.createDirectories(
    vararg attributes: FileAttribute<*>
): Path

Создает новую директорию или выбрасывает исключение, если по этому пути уже существует файл или директория.

fun Path.createDirectory(
    vararg attributes: FileAttribute<*>
): Path

Создает новый пустой файл, указанный этим путем, если файл уже существует.

fun Path.createFile(
    vararg attributes: FileAttribute<*>
): Path

Создает новую ссылку (запись каталога) по этому пути для существующего файла целевой.

fun Path.createLinkPointingTo(target: Path): Path

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

fun Path.createParentDirectories(
    vararg attributes: FileAttribute<*>
): Path

Создает новую символическую ссылку по этому пути на указанный целевой элемент.

fun Path.createSymbolicLinkPointingTo(
    target: Path, 
    vararg attributes: FileAttribute<*>
): Path

Удаляет существующий файл или пустую директорию, указанную этим путем.

fun Path.deleteExisting()

Удаляет файл или пустую директорию, указанную этим путем, если он существует.

fun Path.deleteIfExists(): Boolean

Рекурсивно удаляет этот каталог и его содержимое. Обратите внимание, что если эта функция вызывает ошибку, частичное удаление может уже быть выполнено.

fun Path.deleteRecursively()

Разрешает заданный другой путь относительно этого пути.

operator fun Path.div(other: Path): Path

Разрешает заданный другой строковый путь относительно этого пути.

operator fun Path.div(other: String): Path

Проверяет, существует ли файл, расположенный по этому пути.

fun Path.exists(vararg options: LinkOption): Boolean

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

val Path.extension: String

Возвращает представление атрибутов файла заданного типа V или вызывает UnsupportedOperationException, если запрашиваемый тип представления атрибутов недоступен.

fun <V : FileAttributeView> Path.fileAttributesView(
    vararg options: LinkOption
): V

Возвращает представление атрибутов файла заданного типа V или null если запрашиваемый тип представления атрибутов недоступен.

fun <V : FileAttributeView> Path.fileAttributesViewOrNull(
    vararg options: LinkOption
): V?

Возвращает размер обычного файла в виде значения Long в байтах или вызывает исключение, если файл не существует.

fun Path.fileSize(): Long

Возвращает FileStore, представляющий файловое хранилище, где расположен файл.

fun Path.fileStore(): FileStore

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

fun Path.forEachDirectoryEntry(
    glob: String = "*", 
    action: (Path) -> Unit)

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

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

Читает значение атрибута файла.

fun Path.getAttribute(
    attribute: String, 
    vararg options: LinkOption
): Any?

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

fun Path.getLastModifiedTime(
    vararg options: LinkOption
): FileTime

Возвращает владельца файла.

fun Path.getOwner(vararg options: LinkOption): UserPrincipal?

Возвращает разрешения файла POSIX для файла, расположенного по этому пути.

fun Path.getPosixFilePermissions(
    vararg options: LinkOption
): Set<PosixFilePermission>

Создает новый InputStream этого файла и возвращает его в качестве результата.

fun Path.inputStream(vararg options: OpenOption): InputStream

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

val Path.invariantSeparatorsPathString: String

Проверяет, является ли файл, расположенный по этому пути, каталогом.

fun Path.isDirectory(vararg options: LinkOption): Boolean

Проверяет, существует ли файл, расположенный по этому пути, и является ли он исполняемым.

fun Path.isExecutable(): Boolean

Проверяет, считается ли файл, расположенный по этому пути, скрытым.

fun Path.isHidden(): Boolean

Проверяет, существует ли файл, расположенный по этому пути, и является ли он читаемым.

fun Path.isReadable(): Boolean

Проверяет, является ли файл, расположенный по этому пути, обычным файлом.

fun Path.isRegularFile(vararg options: LinkOption): Boolean

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

fun Path.isSameFileAs(other: Path): Boolean

Проверяет, существует ли файл, расположенный по этому пути, и является ли он символической ссылкой.

fun Path.isSymbolicLink(): Boolean

Проверяет, существует ли файл по этому пути и доступен ли он для записи.

fun Path.isWritable(): Boolean

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

fun Path.listDirectoryEntries(glob: String = "*"): List<Path>

Перемещает или переименовывает файл по этому пути в путь target.

fun Path.moveTo(
    target: Path, 
    vararg options: CopyOption
): Path

fun Path.moveTo(
    target: Path, 
    overwrite: Boolean = false
): Path

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

val Path.name: String

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

val Path.nameWithoutExtension: String

Проверяет, не существует ли файл по этому пути.

fun Path.notExists(vararg options: LinkOption): Boolean

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

fun Path.outputStream(
    vararg options: OpenOption
): OutputStream

Возвращает строковое представление этого пути.

val Path.pathString: String

Считывает атрибуты файла указанного типа A в пакетном режиме.

fun <A : BasicFileAttributes> Path.readAttributes(
    vararg options: LinkOption
): A

Считывает указанный список атрибутов файла в пакетном режиме.

fun Path.readAttributes(
    attributes: String, 
    vararg options: LinkOption
): Map<String, Any?>

Получает всё содержимое этого файла в виде массива байтов.

fun Path.readBytes(): ByteArray

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

fun Path.reader(
    charset: Charset = Charsets.UTF_8, 
    vararg options: OpenOption
): InputStreamReader

Считывает содержимое файла в виде списка строк.

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

Считывает целевой объект символической ссылки, расположенной по этому пути.

fun Path.readSymbolicLink(): Path

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

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

Вычисляет относительный путь для этого пути от пути base.

fun Path.relativeTo(base: Path): Path

Вычисляет относительный путь для этого пути от пути base.

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

Вычисляет относительный путь для этого пути от пути base.

fun Path.relativeToOrSelf(base: Path): Path

Устанавливает значение атрибута файла.

fun Path.setAttribute(
    attribute: String, 
    value: Any?, 
    vararg options: LinkOption
): Path

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

fun Path.setLastModifiedTime(value: FileTime): Path

Устанавливает владельца файла на указанное значение value.

fun Path.setOwner(value: UserPrincipal): Path

Устанавливает разрешения на доступ к POSIX файлу по этому пути.

fun Path.setPosixFilePermissions(
    value: Set<PosixFilePermission>
): Path

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

fun <T> Path.useDirectoryEntries(
    glob: String = "*", 
    block: (Sequence<Path>) -> T
): T

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

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

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

fun Path.visitFileTree(
    visitor: FileVisitor<Path>, 
    maxDepth: Int = Int.MAX_VALUE, 
    followLinks: Boolean = false)

Проходит по этому каталогу и всем его содержимым с помощью FileVisitor, определённого в builderAction.

fun Path.visitFileTree(
    maxDepth: Int = Int.MAX_VALUE, 
    followLinks: Boolean = false, 
    builderAction: FileVisitorBuilder.() -> Unit)

Возвращает последовательность путей для посещения этого каталога и всех его содержимых.

fun Path.walk(vararg options: PathWalkOption): Sequence<Path>

Записывает массив байтов array в этот файл.

fun Path.writeBytes(
    array: ByteArray, 
    vararg options: OpenOption)

Записывает указанную коллекцию последовательностей символов lines в файл, завершая каждую из них разделителем строк платформы.

fun Path.writeLines(
    lines: Iterable<CharSequence>, 
    charset: Charset = Charsets.UTF_8, 
    vararg options: OpenOption
): Path

Записывает указанную последовательность последовательностей символов lines в файл, завершая каждую из них разделителем строк платформы.

fun Path.writeLines(
    lines: Sequence<CharSequence>, 
    charset: Charset = Charsets.UTF_8, 
    vararg options: OpenOption
): Path

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

fun Path.writer(
    charset: Charset = Charsets.UTF_8, 
    vararg options: OpenOption
): OutputStreamWriter

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

fun Path.writeText(
    text: CharSequence, 
    charset: Charset = Charsets.UTF_8, 
    vararg options: OpenOption)