Orkuncakilkaya
4c48077d68
Expand the function-declaration keyword to the full word across the whole
language and toolchain:
fn name(...) -> T { ... } -> function name(...) -> T { ... }
Done as a self-hosting migration: teach the parser both spellings, reseed,
rewrite every .ludic definition to `function`, then drop `fn`. The compiler
now rejects `fn`. Touches the parser, all selfhost/tools/runtime/example/test
sources, the grammars (TextMate shared+vscode, ludic_syntax.h, JetBrains
LudicTokens.kt), the LSP and formatter, the Python doc/vocab tools
(check-impl, check-docs, validate, palette, test-lsp), and the docs
(fences, prose, kw-fn -> kw-function).
Reseeded; C-free bootstrap fixpoint holds. All suites green (45 regression,
24 self-host, 29 tool); the docs site generates and check.py passes.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
38 lines
1.4 KiB
Markdown
38 lines
1.4 KiB
Markdown
---
|
|
id: kw-function
|
|
name: function
|
|
category: structure
|
|
kind: keyword
|
|
tokens: function
|
|
sig: function name(a: T, b: T) -> R { … }
|
|
tip: A function — reusable logic called positionally or with named arguments.
|
|
order: 8
|
|
---
|
|
|
|
A <code>function</code> declares a function: a reusable block of logic with typed parameters and a return type, written `-> R` (use `-> void` for one that returns nothing). Call it positionally, `heal(2, 10)`, or with named arguments, `heal(amount: 2, maximum: 10)`, which reads more clearly at the call site and is the house style. Functions live at program scope alongside handlers and may be called from any handler; they can `spawn`, run queries, and read program-scope state. Use them to factor out logic shared by several handlers so each handler stays short.
|
|
|
|
Parameters:
|
|
- `a`, `b` — the typed inputs; pass them positionally or by name at the call site
|
|
|
|
```ludic
|
|
program Healer {
|
|
property Health { current: int = 100, maximum: int = 100 }
|
|
model Player { Health }
|
|
|
|
function heal(amount: int, maximum: int) -> int {
|
|
let restored = amount * 2
|
|
if restored > maximum { return maximum }
|
|
return restored
|
|
}
|
|
|
|
handler Boot phase Start {
|
|
spawn Hero { Health { current: 10, maximum: 100 } }
|
|
}
|
|
|
|
handler Recover phase Update {
|
|
for (health) in query [Health, {Player}] {
|
|
health.current = heal(amount: health.current, maximum: health.maximum)
|
|
}
|
|
}
|
|
}
|
|
```
|