Reads all strict UTF-8 lines from one snapshot, within the encoded file-size bound. LF, CRLF and CR are removed. Empty files have no lines; a final delimiter adds no extra line.

readText

fun readText(path: Path, maximumBytes: Int = 65536): String

Strict UTF-8; the bound is the encoded byte size, independently of Guest heap quotas.

stat

fun stat(path: Path): FileInfo

statOrNull

fun statOrNull(path: Path): FileInfo?

Only a missing entry returns null. Permission and storage failures still throw.

useLines

inline fun <R> useLines(path: Path, maximumLineBytes: Int = 65536, block: (Sequence<String>) -> R): R

Processes strict UTF-8 lines lazily and closes the snapshot reader after block, including failure and non-local return. The sequence can be traversed once and is usable only inside the block.

writeBytes

fun writeBytes(path: Path, contents: ByteArray)

writeText

fun writeText(path: Path, contents: String)

Strict UTF-8, atomically replacing the entire file. Invalid surrogates never publish.