Library / System / Runtime / System
System
The running program's own services: its environment, its exit, where its
executable lives (programPath), and the process-level runtime around them.
Methods 8
METHOD getenv(REFERENCE String key) RETURNS | Stringreads
Look up an environment variable. Pipe-XOR: SUCCESS populates
value with the variable's value (empty String if set to the
empty value); FAILURE if the variable is unset.
METHOD programPath() RETURNS | Stringreads
The running program's own executable, as the absolute, symlink-free path the operating system reports. Not argv[0]: a shell passes whatever the user typed, often a bare name found on PATH. FAILURE when the system cannot say.
METHOD exit(int32 code) RETURNS voidreads
Exit the process immediately with the given code. Does NOT
return. CLEANUP on stack frames is skipped — call only when
the program genuinely cannot continue. For normal termination,
RETURN from start() instead and let the entry-point shim
propagate the exit code.
METHOD cloneCount() RETURNS int64reads
Deep copies performed so far. See the note above on enabling.
METHOD resetCloneCount() RETURNS voidreads
Zero the counter, so a test can bracket one sequence.
METHOD memoryCompare(REFERENCE binary[] a, int64 aOff, REFERENCE binary[] b, int64 bOff, int64 n) RETURNS int32reads
Lexicographic byte comparison of the n-byte run a[aOff .. aOff+n)
against b[bOff .. bOff+n). Returns a negative int32 when the first
differing byte is smaller in a, positive when larger, and 0 when the
two runs are byte-equal — the std::memcmp result contract, so one
primitive serves both equality (== 0) and ordering. Each offset+run
is bounds-checked once against its array's length.
METHOD memoryCopy(MUTABLE REFERENCE binary[] dst, int64 dstOff, REFERENCE binary[] src, int64 srcOff, int64 n) RETURNS voidreads
Copy the n-byte run src[srcOff .. srcOff+n) into dst[dstOff ..
dstOff+n) in place. PRECONDITION: both ranges are live — dstOff+n
must not exceed dst.length (this is an in-place copy into existing
slots, never a growing append) and srcOff+n must not exceed
src.length; the compiler enforces both with one bounds check per run
(IndexOutOfBoundsError on violation). The source and destination runs
must not overlap. The compiler lowers each call site to one std::memcpy.
METHOD memoryWord(REFERENCE binary[] a, int64 off) RETURNS uint64reads
Read the 8 consecutive bytes a[off .. off+8) as one uint64 — a WIDE
load, for word-wise hashing/scanning that processes eight bytes per
operation instead of one. PRECONDITION: off+8 must not exceed
a.length (the compiler checks it once and raises IndexOutOfBoundsError
otherwise). The compiler lowers each call site to a single native-endian
8-byte load; this body is the readable little-endian spec, which
coincides with the load on the little-endian V1 targets. Byte order is an
internal detail — a word-wise hash only needs the same bytes to map to
the same word, which both forms guarantee.