Hojun-Cho
e5379848de
Pure file-boundary move of lib/io/stream.ww's single 'empty stream' banner section (_empty_read, _empty_write, _empty_vt, empty) into lib/io/empty.ww, mirroring ref/hare/io/empty.ha. No code, name, signature, or behavior change. Comment-only adjustments: the banner line is deleted (the file name carries it); the moved block's 'Lives in stream.ww' self-reference now says empty.ww; stream.ww's head drops its empty bullet (content duplicated by empty.ww's own comments); io.ww's ownership map gains the empty.ww line; types.ww's 'three files' count becomes four. empty.ww needs no imports (package io types only). Makefile: lib/io/empty.ww added beside every lib/io/stream.ww occurrence (WWFIXTURE_SRC line 75; w6c_ww/wwdump_ww bootstrap prereq lists at lines 184/204). lib/io has no _test.ww, so no LIBRARY_TESTS or byteid-roster change; byteid coverage rides the bootstrap gates. Validation: out/bin/w6c lib/io/io.ww (standalone contract) exit 0; importer tests green: bufio 26, memio 11, log 11, getopt 12 (calls io.empty), fmt 49.
28 lines
1.3 KiB
Plaintext
28 lines
1.3 KiB
Plaintext
// io — stream interface (Plan 9 Bio / Hare io::stream shape).
|
|
//
|
|
// No closures, no methods. A `stream` is a pointer to a `vtable` of
|
|
// function pointers (lib/io/stream.ww); read/write/close dispatch
|
|
// through it. The error channel is the return value — Hare-shaped
|
|
// tagged unions instead of errno-style integer sentinels.
|
|
//
|
|
// This file owns the eof / underread variant tags; lib/io/stream.ww
|
|
// owns the `vtable` + `stream` + read/write/close dispatchers,
|
|
// lib/io/empty.ww owns the [[empty]] singleton, and lib/io/types.ww
|
|
// owns the error union, mode/whence enums, and the reader/writer/
|
|
// closer fn-type aliases.
|
|
// #94 fold-eFinal collapsed the pre-vtable `stream` struct + `closed`
|
|
// tag into the single vtable surface; the dispatchers are read/write/
|
|
// close (over `stream`), final over `handle` at io fold-2 (#5).
|
|
package io;
|
|
|
|
// eof — read past the end of the stream. Hare uses the `done`
|
|
// singleton for EOF; ww doesn't have `done` yet so we ship a
|
|
// named-void variant tag. Lifts to `done` with #93.
|
|
export type eof = void;
|
|
|
|
// underread — an I/O handle hit eof partway through a fixed-size
|
|
// read. Payload is the byte count actually delivered. Mirrors
|
|
// Hare's `io::underread = !size`; ww uses i32 because the
|
|
// underlying buffer-length type is i32 today.
|
|
export type underread = !i32;
|