java.nio.file.Path - Kotlin Programming Language

kotlin-stdlib / kotlin.io.path / java.nio.file.Path

Extensions for java.nio.file.Path

JVM

JRE7

1.4

appendBytes

Appends an array of bytes to the content of this file.

fun Path.appendBytes(array: ByteArray)

JVM

JRE7

1.4

appendLines

Appends the specified collection of char sequences lines to a file terminating each one with the platform's line separator.

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

Appends the specified sequence of char sequences lines to a file terminating each one with the platform's line separator.

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

JVM

JRE7

1.4

appendText

Appends text to the content of this file using UTF-8 or the specified charset.

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

JVM

JRE7

1.4

bufferedReader

Returns a new BufferedReader for reading the content of this file.

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

JVM

JRE7

1.4

bufferedWriter

Returns a new BufferedWriter for writing the content of this file.

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

JVM

JRE7

1.4

copyTo

Copies a file or directory located by this path to the given target path.

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

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

JVM

JRE7

1.4

createDirectories

Creates a directory ensuring that all nonexistent parent directories exist by creating them first.

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

JVM

JRE7

1.4

createDirectory

Creates a new directory or throws an exception if there is already a file or directory located by this path.

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

JVM

JRE7

1.4

createFile

Creates a new and empty file specified by this path, failing if the file already exists.

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

JVM

JRE7

1.4

createLinkPointingTo

Creates a new link (directory entry) located by this path for the existing file target.

fun Path.createLinkPointingTo(target: Path): Path

JVM

JRE7

1.4

createSymbolicLinkPointingTo

Creates a new symbolic link located by this path to the given target.

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

JVM

JRE7

1.4

deleteExisting

Deletes the existing file or empty directory specified by this path.

fun Path.deleteExisting()

JVM

JRE7

1.4

deleteIfExists

Deletes the file or empty directory specified by this path if it exists.

fun Path.deleteIfExists(): Boolean

JVM

JRE7

1.4

div

Resolves the given other path against this path.

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

Resolves the given other path string against this path.

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

JVM

JRE7

1.4

exists

Checks if the file located by this path exists.

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

JVM

JRE7

1.4

extension

Returns the extension of this path (not including the dot), or an empty string if it doesn't have one.

val Path.extension: String

JVM

JRE7

1.4

fileAttributesView

Returns a file attributes view of a given type V or throws an UnsupportedOperationException if the requested attribute view type is not available..

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

JVM

JRE7

1.4

fileAttributesViewOrNull

Returns a file attributes view of a given type V or null if the requested attribute view type is not available.

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

JVM

JRE7

1.4

fileSize

Returns the size of a regular file as a Long value of bytes or throws an exception if the file doesn't exist.

fun Path.fileSize(): Long

JVM

JRE7

1.4

fileStore

Returns the FileStore representing the file store where a file is located.

fun Path.fileStore(): FileStore

JVM

JRE7

1.4

forEachDirectoryEntry

Performs the given action on each entry in this directory optionally filtered by matching against the specified glob pattern.

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

JVM

JRE7

1.4

forEachLine

Reads this file line by line using the specified charset and calls action for each line. Default charset is UTF-8.

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

JVM

JRE7

1.4

getAttribute

Reads the value of a file attribute.

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

JVM

JRE7

1.4

getLastModifiedTime

Returns the last modified time of the file located by this path.

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

JVM

JRE7

1.4

getOwner

Returns the owner of a file.

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

JVM

JRE7

1.4

getPosixFilePermissions

Returns the POSIX file permissions of the file located by this path.

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

JVM

JRE7

1.4

inputStream

Constructs a new InputStream of this file and returns it as a result.

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

JVM

JRE7

1.4

invariantSeparatorsPath

Returns this path as a String using the invariant separator '/' to separate the names in the name sequence.

val Path.invariantSeparatorsPath: String

JVM

JRE7

1.4

isDirectory

Checks if the file located by this path is a directory.

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

JVM

JRE7

1.4

isExecutable

Checks if the file located by this path exists and is executable.

fun Path.isExecutable(): Boolean

JVM

JRE7

1.4

isHidden

Checks if the file located by this path is considered hidden.

fun Path.isHidden(): Boolean

JVM

JRE7

1.4

isReadable

Checks if the file located by this path exists and is readable.

fun Path.isReadable(): Boolean

JVM

JRE7

1.4

isRegularFile

Checks if the file located by this path is a regular file.

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

JVM

JRE7

1.4

isSameFileAs

Checks if the file located by this path points to the same file or directory as other.

fun Path.isSameFileAs(other: Path): Boolean

JVM

JRE7

1.4

isSymbolicLink

Checks if the file located by this path exists and is a symbolic link.

fun Path.isSymbolicLink(): Boolean

JVM

JRE7

1.4

isWritable

Checks if the file located by this path exists and is writable.

fun Path.isWritable(): Boolean

JVM

JRE7

1.4

listDirectoryEntries

Returns a list of the entries in this directory optionally filtered by matching against the specified glob pattern.

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

JVM

JRE7

1.4

moveTo

Moves or renames the file located by this path to the target path.

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

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

JVM

JRE7

1.4

name

Returns the name of the file or directory denoted by this path as a string, or an empty string if this path has zero path elements.

val Path.name: String

JVM

JRE7

1.4

nameWithoutExtension

Returns the name of this file or directory without an extension, or an empty string if this path has zero path elements.

val Path.nameWithoutExtension: String

JVM

JRE7

1.4

notExists

Checks if the file located by this path does not exist.

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

JVM

JRE7

1.4

outputStream

Constructs a new OutputStream of this file and returns it as a result.

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

JVM

JRE7

1.4

readAttributes

Reads a file's attributes of the specified type A in bulk.

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

Reads the specified list of attributes of a file in bulk.

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

JVM

JRE7

1.4

readBytes

Gets the entire content of this file as a byte array.

fun Path.readBytes(): ByteArray

JVM

JRE7

1.4

reader

Returns a new InputStreamReader for reading the content of this file.

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

JVM

JRE7

1.4

readLines

Reads the file content as a list of lines.

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

JVM

JRE7

1.4

readSymbolicLink

Reads the target of a symbolic link located by this path.

fun Path.readSymbolicLink(): Path

JVM

JRE7

1.4

readText

Gets the entire content of this file as a String using UTF-8 or the specified charset.

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

JVM

JRE7

1.4

relativeTo

Calculates the relative path for this path from a base path.

fun Path.relativeTo(base: Path): Path

JVM

JRE7

1.4

relativeToOrNull

Calculates the relative path for this path from a base path.

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

JVM

JRE7

1.4

relativeToOrSelf

Calculates the relative path for this path from a base path.

fun Path.relativeToOrSelf(base: Path): Path

JVM

JRE7

1.4

setAttribute

Sets the value of a file attribute.

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

JVM

JRE7

1.4

setLastModifiedTime

Sets the last modified time attribute for the file located by this path.

fun Path.setLastModifiedTime(value: FileTime): Path

JVM

JRE7

1.4

setOwner

Sets the file owner to the specified value.

fun Path.setOwner(value: UserPrincipal): Path

JVM

JRE7

1.4

setPosixFilePermissions

Sets the POSIX file permissions for the file located by this path.

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

JVM

JRE7

1.4

useDirectoryEntries

Calls the block callback with a sequence of all entries in this directory optionally filtered by matching against the specified glob pattern.

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

JVM

JRE7

1.4

useLines

Calls the block callback giving it a sequence of all the lines in this file and closes the reader once the processing is complete.

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

JVM

JRE7

1.4

writeBytes

Writes an array of bytes to this file.

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

JVM

JRE7

1.4

writeLines

Write the specified collection of char sequences lines to a file terminating each one with the platform's line separator.

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

Write the specified sequence of char sequences lines to a file terminating each one with the platform's line separator.

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

JVM

JRE7

1.4

writer

Returns a new OutputStreamWriter for writing the content of this file.

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

JVM

JRE7

1.4

writeText

Sets the content of this file as text encoded using UTF-8 or the specified charset.

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