ludic/docs/language/text/text-slice.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

30 lines
939 B
Markdown

---
id: text-slice
name: Text.slice
category: text
kind: namespace-method
tokens: Text.slice
sig: Text.slice(s, a, b) -> string
tip: A substring covering bytes [a, b).
order: 2
ns: Text
member: slice
---
Returns a fresh string of the bytes from index <code>a</code> up to but not including <code>b</code> — the half-open range <code>[a, b)</code>, so <code>Text.slice("hello world", 0, 5)</code> is <code>"hello"</code>. It is the call form of the <code>s[a..b]</code> slice syntax and allocates a new string. Use it to cut a fixed-width field, drop a prefix, or take the first few characters of a name.
Parameters:
- `s` — the source string
- `a` — the start byte index (inclusive)
- `b` — the end byte index (exclusive)
```ludic
program FirstWord {
var line: string = "hello world"
handler Split phase Update {
let space = Text.index_of(line, " ") # 5
let word = Text.slice(line, 0, space) # "hello"
}
}
```