ludic/docs/language/text/text-concat.md
Orkuncakilkaya b7745a4600 refactor(lang): rename the str type (and stringify builtin) to string
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>
2026-08-30 01:51:11 +03:00

821 B

id name category kind tokens sig tip order ns member
text-concat Text.concat text namespace-method Text.concat Text.concat(a, b) -> string Join two strings into a new one. 8 Text concat

Returns a fresh string that is a followed by b. It is the call form of the a + b string operator and allocates a new string, leaving the inputs untouched. For building a line from several pieces, backtick interpolation such as score: {n} is usually clearer; reach for Text.concat when joining two values you already hold.

Parameters:

  • a — the left string
  • b — the right string
program Greeting {
  var name: string = "world"

  handler Build phase Update {
    let line = Text.concat("hello ", name)   # "hello world"
  }
}