from
Translation status: English reader-locale proof. Term names and code fences follow the en pack; supporting prose may still be English.
Extracts fields from a value into local bindings.
Syntax: from <expression> <const|var> <field> [, ...] [rest <ident>]
Category#
destructuring
Related#
Examples#
radix/corpus/destructura/lista.fab (canonical · keyword)#
Extracts fields from a value into local bindings.
# =============================================================================
# from — Extracts fields from a value into local bindings.
# =============================================================================
#
# What this teaches:
# • Lista destructuring — `const [a, b, c] ← list` extracts elements from a list into individual bindings.
# • Rest patterns — `const [caput, rest cauda] ← list` captures remaining elements.
# • Mutable destructuring — `var [x, y] ← list` for mutable bindings.
# • Skip and nested patterns — underscore `_` skips elements; nested listas destructure recursively.
#
# Common mistakes:
# • Destructuring fewer or more elements than the list contains without handling bounds — pattern must match or the destructuring will fail.
#
# See also: ref, as, rest
# =============================================================================
# destructura — list destructuring patterns
#
# const [a, b, c] ← list
# var [x, y, z] ← list
# const [caput, rest cauda] ← list
# const [_, medius, _] ← list
#
# GRAMMAR:
# destructStmt :← ('const' | 'var') '[' patternList ']' '←' expr
#
# EXPECTED OUTPUT:
# Element values from inline and bound listas, rest slices, nested rows.
main {
# --- Basic list destructuring ---
const _ numeri ← [1, 2, 3]
const [a, b, c] ← numeri
print a
print b
print c
# Destructure inline list literal
const [primus, secundus, tertius] ← [10, 20, 30]
print primus
print secundus
print tertius
# --- Mutable destructuring with var ---
const _ coordinata ← [100, 200]
var [x, y] ← coordinata
print x
print y
x ← x + 50
y ← y + 50
print x
print y
# --- Partial destructuring (fewer variables than elements) ---
const _ valores ← [1, 2, 3, 4, 5]
const [unus, duo] ← valores
print unus
print duo
# --- Rest pattern with rest ---
const _ res ← [1, 2, 3, 4, 5]
const [caput, rest cauda] ← res
print caput
print cauda
# --- Skip elements with underscore ---
const _ triplex ← [10, 20, 30]
const [_, medius, _] ← triplex
print medius
# --- Nested listas ---
const _ matrix ← [[1, 2], [3, 4]]
const [ordo1, ordo2] ← matrix
print ordo1
print ordo2
}Expected output:
1
2
3
10
20
30
100
200
150
250
1
2
1
[2, 3, 4, 5]
20
[1, 2]
[3, 4]
radix/corpus/destructura/objectum.fab (canonical · keyword)#
Extracts fields from a value into local bindings.
# =============================================================================
# from — Extracts fields from a value into local bindings.
# =============================================================================
#
# What this teaches:
# • Field destructuring — `from <expr> const <field>, ...` extracts named fields from class records into local bindings.
# • Aliasing — `from <expr> const <field> as <alias>` renames extracted fields.
# • Mutable extraction — `from <expr> var <field>, ...` for mutable field bindings.
# • Rest pattern — `from <expr> const <field>, rest <rest>` captures remaining fields as a map.
# • Nested paths — `from <expr>.<field> const ...` destructures through nested paths.
#
# Common mistakes:
# • Destructuring a field that does not exist on the target type — the field must be present in the class definition or the type must support open shapes.
#
# See also: ref, as, rest
# =============================================================================
# destructura — field destructuring with `from`
#
# from <expr> const <field>, ...
# from <expr> var <field>, ...
# from <expr> const <field> as <alias>
# from <expr> const <field>, rest <rest>
#
# Field destructuring works on class records (fixed fields) and map/valor
# (open shapes). This tour uses class types so that field names are statically
# known and codegen-complete.
#
# GRAMMAR:
# destructStmt :← 'from' expr ('const' | 'var') patternList
#
# EXPECTED OUTPUT:
# Extracted field values, aliased names, mutated var bindings, rest maps.
class Persona {
var string name
var int aetas
var string urbs
}
class Civis {
var string name
var string epistula
}
class Datum {
var int int
var bool activus
}
class Forma {
var string hospes
var int portus
var bool tutus
}
class Plenus {
var int signum
var string name
var string epistula
var string munus
}
class Sodalis {
var string name
var bool probatus
}
class Relatus {
var Sodalis civis
}
class Responsum {
var Relatus datum
}
class Vestis {
var string modus
var string lingua
}
main {
# --- Basic field extraction ---
const _ persona ← Persona { name = "Marcus", aetas = 30, urbs = "Roma" }
from persona const name, aetas
print name
print aetas
# --- Extract with alias using 'as' ---
const _ civis ← Civis { name = "Julia", epistula = "julia@roma.com" }
from civis const name as cognomen, epistula as epistula2
print cognomen
print epistula2
# --- Mutable destructuring with var ---
const _ datum ← Datum { int = 100, activus = true }
from datum var int, activus
print int
print activus
int ← 200
activus ← false
print int
print activus
# --- Mixed alias and regular fields ---
const _ forma ← Forma { hospes = "localis", portus = 8080, tutus = true }
from forma const hospes, portus as porta, tutus
print hospes
print porta
print tutus
# --- Rest pattern with rest ---
const _ plenus ← Plenus { signum = 1, name = "Gaius", epistula = "g@roma.com", munus = "admin" }
from plenus const signum, rest reliqua
print signum
print reliqua
# --- Destructura from nested path ---
const _ responsum ← Responsum { datum = Relatus { civis = Sodalis { name = "Claudia", probatus = true } } }
from responsum.datum.civis const name as internum, probatus
print internum
print probatus
# --- Single field extraction ---
const _ vestis ← Vestis { modus = "nigrum", lingua = "la" }
from vestis const modus
print modus
}radix/corpus/ex/ex.fab (canonical · keyword)#
Extracts fields from a value into local bindings.
# =============================================================================
# from — Extracts fields from a value into local bindings.
# =============================================================================
#
# What this teaches:
# • Field extraction — `from <expr> const <field>, ...` extracts named fields from class records into local scope.
# • Multiple field extraction — extract several fields from a single expression in one statement.
#
# Common mistakes:
# • Mode mismatch — passing a `ref` (read-only) parameter to an `from` (consume) position, or extracting a field that doesn't exist on the target type.
#
# See also: ref, as, rest
# =============================================================================
# from — field extract statement
#
# GRAMMAR:
# extractStmt :← 'from' expr bindingList
#
# EXPECTED OUTPUT:
# Scalar stdout smoke (see body).
#
# BACKEND:
# Cross-ref: destructura/objectum.fab, for/ex.fab (for from mode).
#
class Persona {
var string name
var int aetas
}
main {
const _ p ← Persona { name = "Marcus", aetas = 30 }
from p const name, aetas
print name
print aetas
}Expected output:
Marcus
30
radix/corpus/itera/destructuring.fab (canonical · keyword)#
Extracts fields from a value into local bindings.
# =============================================================================
# from — Extracts fields from a value into local bindings.
# =============================================================================
#
# What this teaches:
# • Loop-binder destructuring — `for from xs const [a, b] { ... }` binds each
# element through the same pattern grammar as binding-position forms.
# • Records (class) — `for from puncta const {x, y} { ... }` object_pattern
# binds fields by name on each element.
# • Positional tuples — `for from ordines const [a, b] { ... }` binds tuple
# slots positionally.
# • Rest patterns — `for from matricula const [caput, rest cauda]` captures
# the remaining list.
# • Holes — `for from ordines const [_, secundus]` skips a slot with `_`.
#
# Common mistakes:
# • Binding more pattern slots than the tuple element has — the loop binder
# inherits the binding-form width rules and rejects with
# `tuple_index_out_of_bounds`.
# • Naming an element label the tuple does not declare — by-label patterns
# must name declared labels and reject with `unknown_tuple_element_label`.
#
# See also: ref, as, rest
# =============================================================================
# for — destructuring loop binders
#
# for from <collection> <const|var> <pattern> { <body> }
#
# The binder accepts the same array/object patterns as binding position:
# [a, b] positional slots
# {x, y} record fields
# [caput, rest cauda] rest pattern
# [_, x] holes
#
# GRAMMAR:
# forInStmt :← 'for' 'from' expr ('const' | 'var') pattern block
#
# EXPECTED OUTPUT:
# destructuring.expected — sums and elements from every pattern form.
class Punctum {
var int x
var int y
}
main {
# --- Records: object_pattern over list of class elements ---
const _ puncta ← [Punctum { x = 1, y = 2 }, Punctum { x = 3, y = 4 }]
for from puncta const {x, y} {
print x + y
}
# --- Labeled tuples: object_pattern binds by label ---
const list<tuple<gx: int, int>> paria ← [tuple<int, int> [50, 60], tuple<int, int> [70, 80]]
for from paria const {gx} {
print gx
}
# --- Positional tuples: array_pattern over fixed-width rows ---
const list<tuple<int, int>> ordines ← [tuple<int, int> [10, 20], tuple<int, int> [30, 40]]
for from ordines const [a, b] {
print a + b
}
# --- Rest patterns: first element plus the remaining list ---
const _ matricula ← [[1, 2, 3], [4, 5, 6]]
for from matricula const [caput, rest cauda] {
print caput
print cauda[1]
}
# --- Holes: `_` skips a slot ---
for from ordines const [_, secundus] {
print secundus
}
}Expected output:
3
7
50
70
30
70
1
3
4
6
20
40
radix/corpus/itera/ex.fab (canonical · keyword)#
Extracts fields from a value into local bindings.
# =============================================================================
# from — Extracts fields from a value into local bindings.
# =============================================================================
#
# What this teaches:
# • value iteration (`for from`) over list elements — the primary workhorse for iterating over collections
# • transforming values inside the loop body (e.g., doubling each element)
#
# Common mistakes:
# • Using from (value iteration) when ref (key/index iteration) is needed — from iterates values, ref iterates keys or indices.
#
# See also: ref, as, rest
# =============================================================================
# for from — for-in value iteration over listas
#
# for from <collection> const <item> { <body> }
#
# GRAMMAR:
# forInStmt :← 'for' 'from' expr 'const' ident block
#
# EXPECTED OUTPUT:
# ex.expected — numbers, names, and doubled values.
main {
# Iterate over number list
const list<int, 5> numeri ← [1, 2, 3, 4, 5]
for from numeri const n {
print n
}
# Iterate over string list
const list<string, 3> nomina ← ["Marcus", "Julia", "Claudia"]
for from nomina const name {
print name
}
# Transform values
const list<int, 3> valores ← [10, 20, 30]
for from valores const v {
const int duplex ← v * 2
print duplex
}
}Expected output:
1
2
3
4
5
Marcus
Julia
Claudia
20
40
60