रेंडरिंगhi

सेवन

Translation status: हिन्दी reader-locale proof. Term names and code fences follow the hi pack; supporting prose may still be English.

Extracts fields from a value into local bindings.

Syntax: सेवन <expression> <स्थिर|चर> <field> [, ...] [बाकी <ident>]

Category#

destructuring

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