Input, output, and files
Text I/O uses strict UTF-8; binary I/O preserves raw bytes.
Both use explicit IoError results. Input consumption
and external writes may have partial effects before failure; errors do not promise
rollback. Error values and their Result/Option wrappers allocate nothing.
Successful writes and ordinary flushing do not promise durable storage.
- Standard streams and arguments.
- Bytes and lossless Unix paths.
- Native paths, directory enumeration, metadata and links, and walking a tree.
- Whole-file helpers.
- Owned files and modes.
- Reading, writing and synchronization, and positions and truncation.
These APIs are prelude builtins. File I/O currently supports Linux;
unsupported hosts report IoError.Unsupported. Standard-stream input uses the
process descriptor on Unix. Configurable encodings, public OS
descriptors, and lazy file iteration are unsupported.
The imported std.fs/std.path modules add native paths, lazy directory streams,
metadata and a Plenty walker. The finder example
searches directory roots through these APIs.