From afcf96444366fb4b7c83f938763013cbc360aade Mon Sep 17 00:00:00 2001 From: Cliff Click Date: Fri, 13 Nov 2026 16:17:13 -0800 Subject: Array init syntax New array init syntax; used in a bunch of places. Allows e.g. read-only arrays with not-null entries. Fix bug x86 encoding of mem/cmp/fp compares --- chapter31/README.md | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) (limited to 'chapter31/README.md') diff --git a/chapter31/README.md b/chapter31/README.md index b82d9612..356b9cdb 100644 --- a/chapter31/README.md +++ b/chapter31/README.md @@ -24,6 +24,31 @@ animation and the reusable `sys.draw.Button` widget: `make -C chapter31 run-clock CTAGS=`. Click its button or press Space to switch between green seven-segment digits and an analog dial. +## Array initializers + +Arrays can be filled with a list or an index-based initializer: + +```simple +val glyphs = new u16[~]{075557,026227,061247}; // Read-only, inferred length. +val squares = new int[10]{int i -> i*i;}; +val names = new u8[~][~2]{"Alice","Bob"}; // Read-only, non-null strings. +``` + +An explicit list length must be a constant equal to the number of elements. +A generator evaluates its length once and runs in index order, once per element +(zero times for an empty array). Its body supports statements and `return`, or +uses its last expression as the result. It can read surrounding locals but +cannot reassign them. Use `int`, `i64`, or `u32` for the index. + +`[~n]` (or `[~]` with a list) makes the array read-only; `val` alone only fixes +the binding. Initializers can construct arrays of non-null references because +every element is supplied before the array becomes accessible. Read-only access +propagates to referenced elements, following the existing view rules. Initialization runs at runtime; +read-only does not require compile-time evaluation. Canvas's font now uses a +read-only `u16` table, and `sys.text.end` uses a generator for its byte copy. + +## Running the examples + ```sh make -C chapter31 libs CTAGS= # Once while online (also: init or lib). make -C chapter31 run-graphical-tictactoe CTAGS= -- cgit v1.2.3