1
0
mirror of https://github.com/KarolS/millfork.git synced 2024-06-18 00:29:30 +00:00
millfork/docs/stdlib/stdio.md
2020-04-06 00:42:52 +02:00

38 lines
1.2 KiB
Markdown

[< back to index](../doc_index.md)
## stdio
The `stdio` module automatically imports the `string` and `err` modules.
It requires an implementation of `void putchar(byte a)` and therefore works only on targets with console output
(see [the frequently provided definitions](./frequent.md) for details).
On targets with idiosyncratic behaviour of `putchar`, functions in this module inherit that behaviour.
All strings are assumed to be in the default encoding.
#### `void putstr(pointer str, byte len)`
Prints a string of length `len` located at address `str`.
#### `void putstrz(pointer str)`
Prints a null-terminated string located at address `str`.
If the string is longer than 255 bytes, then the behaviour is undefined (might even crash).
#### `void putpstr(pointer pstr)`
Prints a length-prefixed string located at address `str`.
#### `void putword(word w)`
Prints the decimal representation of the 16-bit unsigned integer `w`.
#### `void putsigned16(signed16 x)`
Prints the decimal representation of the 16-bit signed integer `x`.
#### `void ensure_mixedcase()`
On targets that have separate all-caps and mixed-case modes (like most Commodore machines), switches to the mixed-case mode.
On the remaining platforms, does nothing.