< lib/text/SLTextReader.sleela > < SLeeLa Standard Library Definition. > < Definition: SLTextReader -- a comprehensive buffered text-input contract for > < the text library family. > < > < SLTextReader reads decoded text from a source. The byte/stream I/O is a > < runtime concern, so the actual source reads are bridged; the in-language > < layer manages an in-memory pushback/peek buffer and line/position state so a > < caller can drive the reader deterministically. > < * In-language: source naming, charset selection, an in-memory buffer the > < caller can prime/peek/advance, line and offset counters, EOF state. > < * Bridged: open / read / readChar / readLine / ready / close -- the real > < source access; each returns an inspectable "text.bridge:reader::..." > < descriptor the runtime fulfils; never a faked read. > < > < only; #sleela 2.1. > > < Comments are #sleela 2.5 material; < Family: text. Native VM/OS work crosses an explicit bridge. > class SLTextReader { < the source name/path or primed buffer content > String value = ""; < decoding charset > String charset = "UTF-8"; < in-memory lookahead buffer (in-language) > String buffer = ""; < 1-based current line > int line = 1; < characters consumed > int offset = 0; < 1 once the source is exhausted > int atEof = 0; < ---- configuration / lifecycle (in-language) ---------------------- > void set(String v) { value = v; } String get() { return value; } void clear() { value = ""; buffer = ""; line = 1; offset = 0; atEof = 0; } void setCharset(String c) { charset = c; } String getCharset() { return charset; } < In-memory buffer the caller can prime (useful for tests / piping). > void prime(String text) { buffer = buffer + text; } String peekBuffer() { return buffer; } boolean hasBuffered() { return buffer != ""; } void dropBuffer() { buffer = ""; } < Position state (in-language). > int lineNumber() { return line; } int position() { return offset; } boolean isEof() { return atEof == 1; } void markEof() { atEof = 1; } void countLine() { line = line + 1; } void advance(int chars) { offset = offset + chars; } < ---- bridged source access (the real I/O) ------------------------- > String bridge(String op) { return "text.bridge:reader:" + op + ":" + value; } String bridgeArg(String op, String a) { return "text.bridge:reader:" + op + ":" + value + ":" + a; } String open() { return bridge("open"); } String read(String count) { return bridgeArg("read", count); } String readChar() { return bridge("readChar"); } String readLine() { return bridge("readLine"); } String readAll() { return bridge("readAll"); } String ready() { return bridge("ready"); } < not named close(): close is reserved > String closeStream() { return bridge("close"); } < ---- introspection ------------------------------------------------- > String typeName() { return "SLeeLa.text.SLTextReader"; } boolean available() { return true; } < SLCloneable / SLDisposable intent. > SLTextReader copy() { SLTextReader c = new SLTextReader(); c.set(value); c.setCharset(charset); return c; } void dispose() { value = ""; buffer = ""; line = 1; offset = 0; atEof = 0; } < ---- Descriptive metadata (version 1.11 nested-friendly accessors) ---- > < Eleven catalogued attributes with getter/setter pairs, so a GUI, loader, > < or catalog can read and (where appropriate) override each record. > < Values are faithful to the subject's real origin where publicly known. > String metaVersion = "1.0.0"; int metaId = 6; String metaAuthor = "SLeeLa standard library"; String metaDate = "2026-10-23"; String metaCopyright = "MEARVK LLC"; String metaTrademark = "none"; String metaCorporation = "MEARVK LLC"; String metaOrigin = "International"; String metaBirthDate = "2026"; int metaScienceRating = 8; String metaNationalSchedule = "The Java Language Specification (java.io.Reader)"; String getMetaVersion() { return metaVersion; } void setMetaVersion(String v) { metaVersion = v; } int getMetaId() { return metaId; } void setMetaId(int v) { metaId = v; } String getAuthor() { return metaAuthor; } void setAuthor(String v) { metaAuthor = v; } String getDate() { return metaDate; } void setDate(String v) { metaDate = v; } String getCopyright() { return metaCopyright; } void setCopyright(String v) { metaCopyright = v; } String getTrademark() { return metaTrademark; } void setTrademark(String v) { metaTrademark = v; } String getCorporation() { return metaCorporation; } void setCorporation(String v) { metaCorporation = v; } String getOrigin() { return metaOrigin; } void setOrigin(String v) { metaOrigin = v; } String getBirthDate() { return metaBirthDate; } void setBirthDate(String v) { metaBirthDate = v; } int getScienceRating() { return metaScienceRating; } void setScienceRating(int v) { metaScienceRating = v; } String getNationalSchedule() { return metaNationalSchedule; } void setNationalSchedule(String v) { metaNationalSchedule = v; } }