Orkuncakilkaya
b7745a4600
Expand the abbreviated string type and its conversion builtin to the full
word everywhere:
str -> string (the immutable-string type)
str(x) -> str -> string(x) -> string (the stringify builtin;
what `{…}` interpolation calls)
Types are recognized by identifier, and llty maps both spellings to LLVM
`ptr`, so this is an atomic source rewrite: type annotations, the Ludic
type tags, the builtin name/dispatch, and the interpolation desugar, plus
the grammars, LSP, docs (type-str -> type-string, fn-str -> fn-string), and
inventory. int/bool stay (universally accepted, like Math).
Reseeded; C-free fixpoint holds; all suites green (45/24/29); site + check.py OK.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
28 lines
889 B
Markdown
28 lines
889 B
Markdown
---
|
|
id: fn-getenv
|
|
name: getenv
|
|
category: builtins
|
|
kind: builtin
|
|
tokens: getenv
|
|
sig: getenv(name) -> string
|
|
tip: Read an environment variable, returning empty when it is unset.
|
|
order: 23
|
|
---
|
|
|
|
Returns the value of the named environment variable, or an empty string when that variable is not set. Use it to make command-line tools and headless runs configurable without recompiling — reading a data directory, a log level, or a seed from the environment. Check for the empty string to detect an unset variable and fall back to a default. Like the other system builtins, it is aimed at tooling rather than a shipped game loop.
|
|
|
|
Parameters:
|
|
- `name` — the environment variable name to read
|
|
|
|
```ludic
|
|
program ReadConfig {
|
|
handler ShowConfig phase Start {
|
|
let level = getenv("LUDIC_LEVEL")
|
|
if len(level) == 0 {
|
|
print("default")
|
|
} else {
|
|
print(level)
|
|
}
|
|
}
|
|
}
|
|
```
|