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
Related#
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.