طابق

Starts an exhaustive pattern match over a value or values.

Aliases: match

Syntax: طابق <subject> <block>

Category#

control-flow

Related#

• تمايز
• حالة

Examples#

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

Starts an exhaustive pattern match over a value or values.

# =============================================================================
# طابق — Starts an exhaustive pattern match over a value or values.
# =============================================================================
#
# What this teaches:
#   • Exhaustive pattern matching — `طابق <value> { حالة ... }` matches against all variants of a تمايز (tagged union).
#   • Variant destructuring — `حالة <Variant> ثابت <field>, ...` destructures variant payload fields.
#   • Unit variants — variant without payload fields match by name alone.
#
# Common mistakes:
#   • Non-exhaustive match — omitting a variant from `طابق` without a `افتراضي` catchall; every تمايز variant must be covered (SEM040).
#
# See also: تمايز, حالة
# =============================================================================

# طابق — pattern matching on تمايز values
#
# طابق <value> {
#     حالة <Casus> { <body> }
#     حالة <Casus> كـ <alias> { <body> }
#     حالة <Casus> ثابت <bindings> { <body> }
#     حالة <Casus> ثابت <field> كـ <alias> { <body> }
# }
#
# GRAMMAR:
#   discerneStmt :← 'طابق' expr '{' casuClause* '}'
#
# EXPECTED OUTPUT:
#   طابق exempla parata

# تمايز — tagged union / enum declaration
union Condicio {
    Agens,
    Iners,
    Pendens
}

union Nuntius {
    Pulsus {
        int x
        int y
    },
    Clavis {
        string clavis
    },
    Finis
}

# Simple حالة matching on unit variants (no payload)
fn nomina(Condicio s) → string {
    match s {
        case Agens {
            return "agens"
        }
        case Iners {
            return "iners"
        }
        case Pendens {
            return "pendens"
        }
    }
}

# حالة with ثابت bindings destructures variant fields
fn tracta(Nuntius e) → none {
    match e {
        case Pulsus const x, y {
            print "pulsus: § §"(x, y)
        }
        case Clavis const clavis {
            print "clavis: §"(clavis)
        }
        case Finis {
            print "finis"
        }
    }
}

main {
    # nomina/tracta are defined for downstream exempla; smoke check only
    print "discerne exempla parata"
}

Expected output:

discerne exempla parata