PathWalkOption

An enumeration to provide walk options for the Path.walk function. The options can be combined to form the desired walk order and behavior.

Example:

val startDirectory = createTempDirectory()
run {
(startDirectory / "1" / "2" / "3" / "4").createDirectories()
(startDirectory / "1" / "2" / "3" / "a.txt").createFile()
(startDirectory / "1" / "2" / "b.txt").createFile()
(startDirectory / "c.txt").createFile()
}

// Default walk options. Prints:
// 1/2/b.txt
// 1/2/3/a.txt
// c.txt
startDirectory.walk().forEach { path ->
println(path.relativeTo(startDirectory))
}

// Custom walk options. Prints:
// 1
// c.txt
// 1/2
// 1/2/b.txt
// 1/2/3
// 1/2/3/a.txt
// 1/2/3/4
startDirectory.walk(PathWalkOption.INCLUDE_DIRECTORIES, PathWalkOption.BREADTH_FIRST).forEach { path ->
println(path.relativeTo(startDirectory))
}

Note that this enumeration is not exhaustive, and new cases might be added in the future.

Since Kotlin

2.1

Entries

Link copied to clipboard

Includes directory paths in the resulting sequence of the walk.

Link copied to clipboard

Walks in breadth-first order.

Link copied to clipboard

Follows symbolic links to the directories they point to.

Properties

Link copied to clipboard

Returns a Java Class instance of the enum the given constant belongs to.

Since Kotlin 1.7
Link copied to clipboard

Returns a representation of an immutable list of all enum entries, in the order they're declared.

Since Kotlin 2.1
Link copied to clipboard
Since Kotlin 2.1
Link copied to clipboard
Since Kotlin 2.1

Functions

Link copied to clipboard
infix inline fun <T> Comparable<T>.compareTo(other: T): Int

Compares this object with the specified object for order. Returns zero if this object is equal to the specified other object, a negative number if it's less than other, or a positive number if it's greater than other.

Since Kotlin 1.6
Link copied to clipboard

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Since Kotlin 2.1
Link copied to clipboard

Returns an array containing the constants of this enum type, in the order they're declared.

Since Kotlin 2.1