`file`

The file module provides simple file, directory, and path helpers.

use file

FileWriteText("hello.txt", "hello\n")
var text : str = FileReadText("hello.txt")

Errors raise EFileError.

`OFile`

OFile wraps a libc file handle and closes it from its destructor.

var f <- OFile()
f.Open("data.bin", "rb")
var bytes : [*]byte = f.ReadBytes()
f.Close()

Method / property	Meaning
`Open(name, mode)`	open with a libc-style mode such as `"r"`, `"rb"`, `"w"`
`Close()`	close if open
`Opened()` / `.opened`	true when a handle is open
`Size()` / `.size`	file size, preserving current position
`Seek(pos)` / `.position = pos`	seek from file start
`CurPos()` / `.position`	current offset
`Read(ptr, size)`	read bytes into memory
`ReadText()`	read the whole file as `str`
`ReadBytes()`	read the whole file as `[*]byte`
`Write(ptr, size)`	write bytes from memory
`WriteText(text)`	write text
`WriteBytes(bytes)`	write a byte slice

Convenience Functions

FileRead(name, ptr, maxlen)
FileReadText(name)
FileReadBytes(name)

FileWrite(name, ptr, len)
FileWriteText(name, text)
FileWriteBytes(name, bytes)

FileExists(name)
FileRemove(name)

FileExists returns false for directories. FileRemove removes an existing file and raises EFileError for an empty, missing, or unremovable file.

Directories

DirExists("out")
DirCreate("out/nested", true)
DirRemove("out/nested")

DirCreate(path, true) creates missing parent directories. Without true, an existing directory is an error.

Path Helpers

PathSlashSeparators(path)
PathPlatformSeparators(path)
PathToAbsolute(path)
GetCurrentPath()
SetCurrentPath(path)
PathDirName(path)
PathFileName(path)
PathFileExt(path)

PathSlashSeparators() normalizes separators to /, while PathPlatformSeparators() uses \\ on Windows and / elsewhere. PathToAbsolute() resolves a relative path against the current directory and normalizes . and .. path segments. GetCurrentPath() returns the absolute current working directory. SetCurrentPath(path) changes the process working directory.