ludic/docs/language/builtins/fn-file_stdout.md
Orkuncakilkaya effb3f637f refactor(lang): rename the ptr/ptrs types to pointer/pointers
Expand the abbreviated pointer types to full words on the language surface:
  ptr   ->  pointer     (a raw address / FFI handle)
  ptrs  ->  pointers    (a buffer of pointers)

The Ludic type name is distinct from LLVM's own `ptr` spelling: llty() maps
`pointer`/`pointers` to LLVM `ptr`, and the emitted IR keeps `ptr`, so only
the Ludic-level surface changes. Rewrites type annotations across all
sources, the 8 hardcoded pointer type-tags, the `pointers`-buffer indexing
in emit_addr, the grammars/LSP/JetBrains tokens, and the docs
(type-ptr -> type-pointer, type-ptrs -> type-pointers). int/bool keep their
conventional short spelling (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:58:54 +03:00

891 B

id name category kind tokens sig tip order
fn-file_stdout file_stdout builtins builtin file_stdout file_stdout() -> pointer The standard-output stream handle for use with file_write. 50

Returns the handle for the standard-output stream, which you pass to file_write to emit raw bytes. Unlike print, which always appends a newline and handles conversion, writing through this handle gives you exact control over what bytes go out and when — useful for tooling and code generators that must emit precise text. It takes no arguments and always refers to the process's standard output. Pair it with file_stderr when you want to separate normal output from diagnostics.

program WriteLine {
  handler Emit phase Start {
    let out = file_stdout()
    let message = "built\n"
    file_write(out, message, len(message))
  }
}