من
Translation status: العربية reader-locale proof. Term names and code fences follow the ar pack; supporting prose may still be English.
Extracts fields from a value into local bindings.
Syntax: من <expression> <ثابت|متغير> <field> [, ...] [باقي <ident>]
Category#
destructuring
Related#
Examples#
radix/corpus/destructura/lista.fab (canonical · keyword)#
Extracts fields from a value into local bindings.
# =============================================================================
# من — Extracts fields from a value into local bindings.
# =============================================================================
#
# What this teaches:
# • Lista destructuring — `ثابت [a, b, c] ← قائمة` extracts elements from a قائمة into individual bindings.
# • Rest patterns — `ثابت [caput, باقي cauda] ← قائمة` captures remaining elements.
# • Mutable destructuring — `متغير [x, y] ← قائمة` for mutable bindings.
# • Skip and nested patterns — underscore `_` skips elements; nested listas destructure recursively.
#
# Common mistakes:
# • Destructuring fewer or more elements than the قائمة contains without handling bounds — pattern must match or the destructuring will fail.
#
# See also: عن, كـ, باقي
# =============================================================================
# destructura — قائمة destructuring patterns
#
# ثابت [a, b, c] ← قائمة
# متغير [x, y, z] ← قائمة
# ثابت [caput, باقي cauda] ← قائمة
# ثابت [_, medius, _] ← قائمة
#
# GRAMMAR:
# destructStmt :← ('ثابت' | 'متغير') '[' patternList ']' '←' expr
#
# EXPECTED OUTPUT:
# Element values from inline and bound listas, rest slices, nested rows.
main {
# --- Basic قائمة destructuring ---
const _ numeri ← [1, 2, 3]
const [a, b, c] ← numeri
print a
print b
print c
# Destructure inline قائمة literal
const [primus, secundus, tertius] ← [10, 20, 30]
print primus
print secundus
print tertius
# --- Mutable destructuring with متغير ---
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 باقي ---
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 _ مصفوفة ← [[1, 2], [3, 4]]
const [ordo1, ordo2] ← مصفوفة
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.
# =============================================================================
# من — Extracts fields from a value into local bindings.
# =============================================================================
#
# What this teaches:
# • Field destructuring — `من <expr> ثابت <field>, ...` extracts named fields from صنف records into local bindings.
# • Aliasing — `من <expr> ثابت <field> كـ <alias>` renames extracted fields.
# • Mutable extraction — `من <expr> متغير <field>, ...` for mutable field bindings.
# • Rest pattern — `من <expr> ثابت <field>, باقي <rest>` captures remaining fields as a جدول.
# • Nested paths — `من <expr>.<field> ثابت ...` destructures through nested paths.
#
# Common mistakes:
# • Destructuring a field that does not exist on the target type — the field must be present in the صنف definition or the type must support open shapes.
#
# See also: عن, كـ, باقي
# =============================================================================
# destructura — field destructuring with `من`
#
# من <expr> ثابت <field>, ...
# من <expr> متغير <field>, ...
# من <expr> ثابت <field> كـ <alias>
# من <expr> ثابت <field>, باقي <rest>
#
# Field destructuring works on صنف records (fixed fields) and جدول/valor
# (open shapes). This tour uses صنف types so that field names are statically
# known and codegen-complete.
#
# GRAMMAR:
# destructStmt :← 'من' expr ('ثابت' | 'متغير') patternList
#
# EXPECTED OUTPUT:
# Extracted field values, aliased names, mutated متغير bindings, rest maps.
class Persona {
var string اسم
var int aetas
var string urbs
}
class Civis {
var string اسم
var string epistula
}
class Datum {
var int عدد
var bool activus
}
class Forma {
var string hospes
var int portus
var bool tutus
}
class Plenus {
var int signum
var string اسم
var string epistula
var string munus
}
class Sodalis {
var string اسم
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 { اسم = "Marcus", aetas = 30, urbs = "Roma" }
from persona const اسم, aetas
print اسم
print aetas
# --- Extract with alias using 'كـ' ---
const _ civis ← Civis { اسم = "Julia", epistula = "julia@roma.com" }
from civis const اسم as cognomen, epistula as epistula2
print cognomen
print epistula2
# --- Mutable destructuring with متغير ---
const _ datum ← Datum { عدد = 100, activus = true }
from datum var عدد, activus
print عدد
print activus
عدد ← 200
activus ← false
print عدد
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 باقي ---
const _ plenus ← Plenus { signum = 1, اسم = "Gaius", epistula = "g@roma.com", munus = "admin" }
from plenus const signum, rest reliqua
print signum
print reliqua
# --- Destructura من nested path ---
const _ responsum ← Responsum { datum = Relatus { civis = Sodalis { اسم = "Claudia", probatus = true } } }
from responsum.datum.civis const اسم 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.
# =============================================================================
# من — Extracts fields from a value into local bindings.
# =============================================================================
#
# What this teaches:
# • Field extraction — `من <expr> ثابت <field>, ...` extracts named fields from صنف records into local scope.
# • Multiple field extraction — extract several fields from a single expression in one statement.
#
# Common mistakes:
# • Mode mismatch — passing a `عن` (read-only) parameter to an `من` (consume) position, or extracting a field that doesn't exist on the target type.
#
# See also: عن, كـ, باقي
# =============================================================================
# من — field extract statement
#
# GRAMMAR:
# extractStmt :← 'من' expr bindingList
#
# EXPECTED OUTPUT:
# Scalar stdout smoke (see body).
#
# BACKEND:
# Cross-ref: destructura/objectum.fab, كرر/ex.fab (كرر من mode).
#
class Persona {
var string اسم
var int aetas
}
main {
const _ p ← Persona { اسم = "Marcus", aetas = 30 }
from p const اسم, aetas
print اسم
print aetas
}Expected output:
Marcus
30
radix/corpus/itera/destructuring.fab (canonical · keyword)#
Extracts fields from a value into local bindings.
# =============================================================================
# من — 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 (صنف) — `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 قائمة.
# • 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: عن, كـ, باقي
# =============================================================================
# كرر — 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 :← 'كرر' 'من' expr ('ثابت' | 'متغير') 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 قائمة of صنف 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 قائمة ---
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.
# =============================================================================
# من — Extracts fields from a value into local bindings.
# =============================================================================
#
# What this teaches:
# • value iteration (`كرر من`) over قائمة elements — the primary workhorse for iterating over collections
# • transforming values inside the loop body (e.g., doubling each element)
#
# Common mistakes:
# • Using من (value iteration) when عن (key/index iteration) is needed — من iterates values, عن iterates keys or indices.
#
# See also: عن, كـ, باقي
# =============================================================================
# كرر من — for-in value iteration over listas
#
# كرر من <collection> ثابت <item> { <body> }
#
# GRAMMAR:
# forInStmt :← 'كرر' 'من' expr 'ثابت' ident block
#
# EXPECTED OUTPUT:
# ex.expected — numbers, names, and doubled values.
main {
# Iterate over number قائمة
const list<int, 5> numeri ← [1, 2, 3, 4, 5]
for from numeri const n {
print n
}
# Iterate over نص قائمة
const list<string, 3> nomina ← ["Marcus", "Julia", "Claudia"]
for from nomina const اسم {
print اسم
}
# 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