Renderingen-US

Experimental through version 1. Version 0 was alpha. This is the first language release: the interface is relatively stable, not frozen. Nothing is promised stable until version 2.

interface

Translation status: English reader-locale proof. Term names and code fences follow the en pack; supporting prose may still be English.

Declares a behavioral contract with method signatures.

Aliases: interface

Syntax: interface <name> [<type-params>] <block>

Category#

class

Examples#

radix/corpus/reference/keyword/implendum/implendum.fab (canonical · keyword)#

Declares a behavioral contract with method signatures.

# =============================================================================
# interface — Declares a behavioral contract with method signatures
# =============================================================================
#
# What this teaches:
#   • Declares a behavioral contract with method signatures.
#   • Related keywords: class, implements
#
# Common mistakes:
#   • Declaring a `class implements Implendum` without implementing all required methods — every method signature in the interface must have a body in the class.
#
# See also: class, implements
# =============================================================================

# interface definition and implementation
#
# interface Nomen { fn opus() → <type> }
# class Nomen implements Implendum { ... }
#
# GRAMMAR:
#   implendumDecl :← 'interface' ident '{' methodSig* '}'
#   genusDecl     :← 'class' ident 'implements' ident '{' ... '}'
#
# EXPECTED OUTPUT:
#   circulus radius: 25
#   quadratum latus: 15

interface Figurabile {
    fn depinge() → void
}

class Circulus implements Figurabile {
    mut int radius = 10

    fn depinge() → void {
        print "circulus radius: §"(self.radius)
    }
}

class Quadratum implements Figurabile {
    mut int latus = 5

    fn depinge() → void {
        print "quadratum latus: §"(self.latus)
    }
}

main {
    let Circulus circulus ← Circulus { radius = 25 }
    let Quadratum quadratum ← Quadratum { latus = 15 }
    circulus.depinge()
    quadratum.depinge()
}

Expected output:

circulus radius: 25
quadratum latus: 15

radix/corpus/reference/reject/implendum/conformance-missing-method-reject.fab (supporting · reject)#

A class that implements an interface must declare every interface method.

# This exemplum intentionally fails to compile: `Circulus` implements
# `Figurabile` without declaring `depinge`.

interface Figurabile {
    fn depinge() → void
    fn name() → string
}

class Circulus implements Figurabile {
    mut int radius = 1

    fn name() → string {
        return "circulus"
    }
}

main {
    let Circulus circulus ← Circulus { radius = 2 }
    print circulus.nomen()
}

Expected: compilation rejects this example.

radix/corpus/reference/reject/implendum/conformance-signature-reject.fab (supporting · reject)#

A class that implements an interface must match each method's signature.

# This exemplum intentionally fails to compile: `Quadratum` declares `area`
# with a `string` return where `Figurabile` requires `int`.

interface Figurabile {
    fn area() → int
}

class Quadratum implements Figurabile {
    mut int latus = 3

    fn area() → string {
        return "nine"
    }
}

main {
    let Quadratum quadratum ← Quadratum { latus = 4 }
    print quadratum.area()
}

Expected: compilation rejects this example.