spread

Spreads an array or collection literal into its surrounding expression.

Aliases: ...

Syntax: spread <expression>

Category#

collection

Related#

• list

Examples#

radix/corpus/sparge/sparge.fab (canonical · keyword)#

Spreads an array or collection literal into its surrounding expression.

# =============================================================================
# spread — Spreads an array or collection literal into its surrounding expression.
# =============================================================================
#
# What this teaches:
#   • Spread syntax — how to splice a collection into a list literal or function call
#   • Collection composition — building larger expressions by expanding collections inline
#
# Common mistakes:
#   • confusing spread (splice) with appende, or using spread on a non-collection expression
#
# See also: list
# =============================================================================

# spread — spread a collection into another collection or call
#
# [a, spread <list>, b]           -- splice into list literal
# fn(spread <list>)          -- spread call arguments
#
# GRAMMAR:
#   spargeExpr :← 'spread' expr
#
# EXPECTED OUTPUT:
#   1, 2, 3, 4 (expanded list elements).

main {
    const list<int> media ← [2, 3]
    # → [1, 2, 3, 4]
    const list<int> numeri ← [1, spread media, 4]
    for from numeri const n {
        print n
    }
}

Expected output:

1
2
3
4